Implementation Management#

Structures used for implementation management.

API#

mfxAdapterInfo#

struct mfxAdapterInfo#

Contains a description of the graphics adapter for the Legacy mode.

Public Members

mfxPlatform Platform#

Platform type description. See mfxPlatform for details.

mfxU32 Number#

Value which uniquely characterizes media adapter. On Windows* this number can be used for initialization through DXVA interface (see example).

mfxAdaptersInfo#

struct mfxAdaptersInfo#

Contains description of all graphics adapters available on the current system.

Public Members

mfxAdapterInfo *Adapters#

Pointer to array of mfxAdapterInfo structs allocated by user.

mfxU32 NumAlloc#

Length of Adapters array.

mfxU32 NumActual#

Number of Adapters entries filled by MFXQueryAdapters.

mfxExtThreadsParam#

struct mfxExtThreadsParam#

Specifies options for threads created by this session. Attached to the mfxInitParam structure during legacy Intel(r) Media SDK session initialization or to mfxInitializationParam by the dispatcher in MFXCreateSession function.

Public Members

mfxExtBuffer Header#

Extension buffer header. Header.BufferId must be equal to MFX_EXTBUFF_THREADS_PARAM.

mfxU16 NumThread#

The number of threads.

mfxI32 SchedulingType#

Scheduling policy for all threads.

mfxI32 Priority#

Priority for all threads.

mfxU16 reserved[55]#

Reserved for future use.

mfxInitParam#

struct mfxInitParam#

Specifies advanced initialization parameters. A zero value in any of the fields indicates that the corresponding field is not explicitly specified.

Public Members

mfxIMPL Implementation#

Enumerator that indicates the desired legacy Intel(r) Media SDK implementation.

mfxVersion Version#

Structure which specifies minimum library version or zero, if not specified.

mfxU16 ExternalThreads#

Desired threading mode. Value 0 means internal threading, 1 - external.

mfxExtBuffer **ExtParam#

Points to an array of pointers to the extra configuration structures; see the ExtendedBufferID enumerator for a list of extended configurations.

mfxU16 NumExtParam#

The number of extra configuration structures attached to this structure.

mfxU16 GPUCopy#

Enables or disables GPU accelerated copying between video and system memory in legacy Intel(r) Media SDK components. See the GPUCopy enumerator for a list of valid values.

mfxPlatform#

struct mfxPlatform#

Contains information about hardware platform for the Legacy mode.

Public Members

mfxU16 CodeName#

Deprecated.

mfxU16 DeviceId#

Unique identifier of graphics device.

mfxU16 MediaAdapterType#

Description of graphics adapter type. See the mfxMediaAdapterType enumerator for a list of possible values.

mfxU16 reserved[13]#

Reserved for future use.

mfxVersion#

union mfxVersion#
#include <mfxcommon.h>

The mfxVersion union describes the version of the implementation.

Major and Minor fields

Anonymous structure with Major and Minor fields.

mfxU16 Minor#

Minor number of the implementation.

mfxU16 Major#

Major number of the implementation.

Public Members

struct mfxVersion::[anonymous] [anonymous]#
mfxU32 Version#

Implementation version number.

mfxExtDeviceAffinityMask#

struct mfxExtDeviceAffinityMask#

The mfxExtDeviceAffinityMask structure is used by the application to specify affinity mask for the device with given device ID. See mfxDeviceDescription for the device ID definition and sub device indexes. If the implementation manages CPU threads for some purpose, the user can set the CPU thread affinity mask by using this structure with DeviceID set to “CPU”.

Public Members

mfxExtBuffer Header#

Extension buffer header. Header.BufferId must be equal to MFX_EXTBUFF_DEVICE_AFFINITY_MASK.

mfxChar DeviceID[MFX_STRFIELD_LEN]#

Null terminated string with device ID. In case of CPU affinity mask it must be equal to “CPU”.

mfxU32 NumSubDevices#

Number of sub devices or threads in case of CPU in the mask.

mfxU8 *Mask#

Mask array. Every bit represents sub-device (or thread for CPU). “1” means execution is allowed. “0” means that execution is prohibited on this sub-device (or thread). Length of the array is equal to the: “NumSubDevices / 8” and rounded to the closest (from the right) integer. Bits order within each entry of the mask array is LSB: bit 0 holds data for sub device with index 0 and bit 8 for sub device with index 8. Index of sub device is defined by the mfxDeviceDescription structure.

mfxInitializationParam#

struct mfxInitializationParam#

Specifies initialization parameters for API version starting from 2.0.

Public Members

mfxAccelerationMode AccelerationMode#

Hardware acceleration stack to use. OS dependent parameter. Use VA for Linux*, DX* for Windows* or HDDL.

mfxU16 DeviceCopy#

Enables or disables device’s accelerated copying between device and host. See the GPUCopy enumerator for a list of valid values. This parameter is the equivalent of mfxInitParam::GPUCopy.

mfxU16 reserved[2]#

Reserved for future use.

mfxU16 NumExtParam#

The number of extra configuration structures attached to this structure.

mfxExtBuffer **ExtParam#

Points to an array of pointers to the extra configuration structures; see the ExtendedBufferID enumerator for a list of extended configurations.

mfxU32 VendorImplID#

Vendor specific number with given implementation ID. Represents the same field from mfxImplDescription.

mfxU32 reserved2[3]#

Reserved for future use.

mfxAutoSelectImplDeviceHandle#

struct mfxAutoSelectImplDeviceHandle#

Specifies that an implementation should be selected which matches the device handle provided by the application.

Public Members

mfxAutoSelectImplType AutoSelectImplType#

Must be set to MFX_AUTO_SELECT_IMPL_TYPE_DEVICE_HANDLE.

mfxAccelerationMode AccelMode#

Hardware acceleration mode of provided device handle.

mfxHandleType DeviceHandleType#

Type of provided device handle.

mfxHDL DeviceHandle#

System handle to hardware device.

mfxU16 reserved[8]#

Reserved for future use.