Функция MFTEnum2 (mfapi.h)

Статья
02/28/2024

Возвращает список преобразований Microsoft Media Foundation (MFT), соответствующих указанным условиям поиска. Эта функция расширяет функцию MFTEnumEx , позволяя внешним приложениям и внутренним компонентам обнаруживать аппаратные MFT, соответствующие конкретному видеоадаптеду.

Синтаксис

HRESULT MFTEnum2(
  [in]           GUID                         guidCategory,
  [in]           UINT32                       Flags,
  [in]           const MFT_REGISTER_TYPE_INFO *pInputType,
  [in]           const MFT_REGISTER_TYPE_INFO *pOutputType,
  [in, optional] IMFAttributes                *pAttributes,
  [out]          IMFActivate                  ***pppMFTActivate,
  [out]          UINT32                       *pnumMFTActivate
);

Параметры

[in] guidCategory

GUID, указывающий категорию перечисляемых MFT. Список категорий MFT см. в разделе MFT_CATEGORY.

[in] Flags

Побитовое ИЛИ , равное нулю или нескольким флагам из перечисления _MFT_ENUM_FLAG .

[in] pInputType

Указатель на структуру MFT_REGISTER_TYPE_INFO , указывающую тип входного носителя для сопоставления.

Этот параметр может принимать значение NULL. Если значение РАВНО NULL, все типы входных данных совпадают.

[in] pOutputType

Указатель на структуру MFT_REGISTER_TYPE_INFO , указывающую тип выходного носителя для сопоставления.

Этот параметр может принимать значение NULL. При значении NULL все типы выходных данных совпадают.

[in, optional] pAttributes

Указатель на интерфейс IMFAttributes , который обеспечивает доступ к стандартному хранилищу атрибутов. Чтобы указать конкретный аппаратный адаптер, для которого запрашиваются MFT, задайте для атрибута MFT_ENUM_ADAPTER_LUID значение LUID адаптера. В этом случае необходимо также указать флаг MFT_ENUM_FLAG_HARDWARE, иначе возвращается E_INVALIDARG.

[out] pppMFTActivate

Получает массив указателей интерфейса IMFActivate . Каждый указатель представляет объект активации для MFT, соответствующий условиям поиска. Функция выделяет память для массива. Вызывающий объект должен освободить указатели и вызвать функцию CoTaskMemFree , чтобы освободить память для массива.

[out] pnumMFTActivate

Получает количество элементов в массиве pppMFTActivate . Если никакие MFT не соответствуют условиям поиска, этот параметр получает нулевое значение.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата	Описание
E_INVALIDARG	В параметре pAttributes был указан атрибут IMFAttributes, содержащий атрибут MFT_ENUM_ADAPTER_LUID, а флаг MFT_ENUM_FLAG_HARDWARE не указан.

Flag	Описание
MFT_ENUM_FLAG_SYNCMFT	MFT выполняет синхронную обработку данных в программном обеспечении. Это исходная модель обработки MFT, совместимая с Windows Vista.
MFT_ENUM_FLAG_ASYNCMFT	MFT выполняет асинхронную обработку данных в программном обеспечении. Для этой модели обработки требуется Windows 7. Дополнительные сведения см. в разделе Асинхронные MFT.
MFT_ENUM_FLAG_HARDWARE	MFT выполняет аппаратную обработку данных, используя драйвер AVStream или прокси-сервер на основе GPU MFT. MFT в этой категории всегда обрабатывают данные асинхронно. Дополнительные сведения см. в разделе Аппаратные MFT. Примечание Если в параметре pAttributes указан атрибут IMFAttributes, содержащий атрибут MFT_ENUM_ADAPTER_LUID, необходимо задать флаг MFT_ENUM_FLAG_HARDWARE, иначе будет возвращено E_INVALIDARG.

Каждый MFT относится именно к одной из этих категорий. Чтобы перечислить категорию, установите соответствующий флаг в параметре Flags . Эти флаги можно объединить для перечисления нескольких категорий. Если ни один из этих флагов не указан, по умолчанию используется категория синхронных MFT (MFT_ENUM_FLAG_SYNCMFT).

Далее следующие флаги включают MFT, которые в противном случае исключены из результатов. По умолчанию флаги, соответствующие этим критериям, исключаются из результатов. Используйте все эти флаги, чтобы включить их.

Flag	Описание
MFT_ENUM_FLAG_FIELDOFUSE	Включите MFT, которые должны быть разблокированы приложением.
MFT_ENUM_FLAG_LOCALMFT	Включите MFT, зарегистрированные в процессе вызывающего объекта с помощью функции MFTRegisterLocal или MFTRegisterLocalByCLSID .
MFT_ENUM_FLAG_TRANSCODE_ONLY	Включите MFT, оптимизированные для перекодирования, а не для воспроизведения.

Последний флаг используется для сортировки и фильтрации результатов:

Flag	Описание
MFT_ENUM_FLAG_SORTANDFILTER	Отсортируйте и отфильтруйте результаты.

Если установлен флаг MFT_ENUM_FLAG_SORTANDFILTER , функция MFTEnum2 сортирует результаты следующим образом:

Local: если установлен флаг MFT_ENUM_FLAG_LOCALMFT , сначала в списке отображаются локальные MFT. Чтобы зарегистрировать локальный MFT, вызовите функцию MFTRegisterLocal или MFTRegisterLocalByCLSID .
Заслуга: MFT со значением заслуги появляются в списке в порядке значения заслуги (от самого высокого до самого низкого). Дополнительные сведения о заслугах см. в разделе MFT_CODEC_MERIT_Attribute.
Предпочтительно: если MFT указан в списке предпочтительных элементов управления подключаемым модулем, он отображается далее в списке. Дополнительные сведения о подключаемом элементе управления см. в разделе IMFPluginControl.
Если MFT отображается в списке заблокированных, он исключается из результатов. Дополнительные сведения о списке заблокированных см. в разделе IMFPluginControl::IsDisabled.
Все остальные MFT, соответствующие условиям поиска, отображаются в конце списка без сортировки.

Если флаг MFT_ENUM_FLAG_SORTANDFILTER не задан, функция MFTEnum2 возвращает несортированные списки.

Установка нулевого значения параметра Flags эквивалентна использованию значения MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT | MFT_ENUM_FLAG_SORTANDFILTER.

Задание флагамMFT_ENUM_FLAG_SYNCMFT эквивалентно вызову функции MFTEnum .

Если никакие MFT не соответствуют условиям поиска, функция возвращает S_OK, если не возникает какая-то другая ошибка. Поэтому перед разыменовыванием указателя pppMFTActivate всегда проверка число, полученное в параметре pcMFTActivate.

Примечание Невозможно перечислить только локальные MFT и ничего другого. Установка флагов, равныхMFT_ENUM_FLAG_LOCALMFT , эквивалентна включению флага MFT_ENUM_FLAG_SYNCMFT . Однако если вы также отсортируете результаты, указав флаг MFT_ENUM_FLAG_SORTANDFILTER , сначала в списке появятся локальные MFT.

Создание MFT

Если хотя бы один MFT соответствует условиям поиска, параметр pppMFTActivate получает массив указателей IMFActivate . Для каждого соответствующего MFT возвращается один указатель. Каждый указатель представляет объект активации для MFT. Дополнительные сведения см. в разделе Объекты активации.

Дополнительные сведения о каждом MFT хранятся в виде атрибутов в объектах активации. Список возможных атрибутов см. в разделе Преобразование атрибутов.

Чтобы создать экземпляр MFT, вызовите IMFActivate::ActivateObject.

Аппаратные кодеки

Аппаратные кодеки исключаются из результатов перечисления, если для следующих разделов реестра задано нулевое значение:

Декодеры: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\HardwareMFT\EnableDecoders

Кодировщики: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\HardwareMFT\EnableEncoders

Видеопроцессоры: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\HardwareMFT\EnableVideoProcessors

Эти ключи предназначены для изготовителей оборудования и не должны использоваться приложениями.

Для аппаратных кодеков параметр guidCategoryMFTEnum2 также может указывать одну из следующих категорий устройств потоковой передачи ядра (KS):

KSCATEGORY_DATACOMPRESSOR
KSCATEGORY_DATADECOMPRESSOR

Аппаратные кодеки также должны быть зарегистрированы в MFT_CATEGORY GUID, поэтому приложения, как правило, должны использовать эти категории вместо категорий устройств KS.

Примеры

В следующем примере извлекается первый доступный IDXGIAdapter1 и получается LUID адаптера, необходимый для идентификации адаптера в последующих примерах.

HRESULT hr = S_OK;
IDXGIFactory1 *pDxgiFactory = NULL;
IDXGIAdapter1 *pDxgiAdapter = NULL;
LUID adapterLuid;

if (FAILED(hr = CreateDXGIFactory1(__uuidof(IDXGIFactory1), (void **)&pDxgiFactory)))
{
    return hr;
}

if (FAILED(hr = pDxgiFactory->EnumAdapters1(0, &pDxgiAdapter)))
{
    return hr;
}

DXGI_ADAPTER_DESC1 AdapterDescr;
if (FAILED(hr = pDxgiAdapter->GetDesc1(&AdapterDescr)))
{
    if (pDxgiAdapter)
    {
        pDxgiAdapter->Release();
        pDxgiAdapter = NULL;
    }
    return hr;
}

adapterLuid = AdapterDescr.AdapterLuid;

В следующем примере выполняется поиск аппаратного декодера видео или аудио. Асинхронные декодеры, декодеры оборудования, транскода и области использования исключаются. Если совпадение найдено, код создает первый MFT в списке. В отличие от параллельного примера в статье MFTEnumEx , этот пример создает экземпляр IMFAttributes и задает для атрибута MFT_ENUM_ADAPTER_LUID значение LUID интерфейса, из которого запрашивается декодер. В вызове MFTEnum2 устанавливается обязательный флаг MFT_ENUM_FLAG_HARDWARE и предоставляется аргумент IMFAttributes .

HRESULT FindHWDecoder(
    const GUID& subtype,        // Subtype
    BOOL bAudio,                // TRUE for audio, FALSE for video
    LUID& adapterLuid,          // LUID of the graphics adapter for which to find the decoder
    IMFTransform **ppDecoder    // Receives a pointer to the decoder.
)
{
    HRESULT hr = S_OK;

    
    UINT32 count = 0;

    IMFActivate **ppActivate = NULL;

    CComPtr<IMFAttributes> spAttributes;
    hr = MFCreateAttributes(&spAttributes, 1);
    if (FAILED(hr = spAttributes->SetBlob(MFT_ENUM_ADAPTER_LUID, (BYTE*)&adapterLuid, sizeof(LUID))))
    {
        return hr;
    }


    MFT_REGISTER_TYPE_INFO info = { 0 };

    info.guidMajorType = bAudio ? MFMediaType_Audio : MFMediaType_Video;
    info.guidSubtype = subtype;

    hr = MFTEnum2(
        bAudio ? MFT_CATEGORY_AUDIO_DECODER : MFT_CATEGORY_VIDEO_DECODER,
        MFT_ENUM_FLAG_HARDWARE | MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT | MFT_ENUM_FLAG_SORTANDFILTER,
        &info,      // Input type
        NULL,       // Output type
        spAttributes,
        &ppActivate,
        &count
    );

    if (SUCCEEDED(hr) && count == 0)
    {
        hr = MF_E_TOPO_CODEC_NOT_FOUND;
    }

    // Create the first decoder in the list.

    if (SUCCEEDED(hr))
    {
        hr = ppActivate[0]->ActivateObject(IID_PPV_ARGS(ppDecoder));
    }

    for (UINT32 i = 0; i < count; i++)
    {
        ppActivate[i]->Release();
    }
    CoTaskMemFree(ppActivate);

    return hr;
}

В следующем примере выполняется поиск аппаратного кодировщика видео или аудио. Асинхронные, аппаратные кодировщики, кодировщики и кодировщики полей использования исключаются. В отличие от параллельного примера в статье MFTEnumEx , этот пример создает экземпляр IMFAttributes и задает для атрибута MFT_ENUM_ADAPTER_LUID ЗНАЧЕНИЕ LUID интерфейса, из которого запрашивается кодировщик. В вызове MFTEnum2 устанавливается обязательный флаг MFT_ENUM_FLAG_HARDWARE и предоставляется аргумент IMFAttributes .

HRESULT FindHWEncoder(
    const GUID& subtype,        // Subtype
    BOOL bAudio,                // TRUE for audio, FALSE for video
    LUID& adapterLuid,          // LUID of the graphics adapter for which to find the encoder
    IMFTransform **ppEncoder    // Receives a pointer to the decoder.
)
{
    HRESULT hr = S_OK;
    UINT32 count = 0;

    IMFActivate **ppActivate = NULL;

    CComPtr<IMFAttributes> spAttributes;
    hr = MFCreateAttributes(&spAttributes, 1);
    if (FAILED(hr = spAttributes->SetBlob(MFT_ENUM_ADAPTER_LUID, (BYTE*)&adapterLuid, sizeof(LUID))))
    {
        return hr;
    }

    MFT_REGISTER_TYPE_INFO info = { 0 };

    info.guidMajorType = bAudio ? MFMediaType_Audio : MFMediaType_Video;
    info.guidSubtype = subtype;

    hr = MFTEnum2(
        bAudio ? MFT_CATEGORY_AUDIO_ENCODER : MFT_CATEGORY_VIDEO_ENCODER,
        MFT_ENUM_FLAG_HARDWARE | MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT | MFT_ENUM_FLAG_SORTANDFILTER,
        NULL,       // Input type
        &info,      // Output type
        spAttributes,
        &ppActivate,
        &count
    );

    if (SUCCEEDED(hr) && count == 0)
    {
        hr = MF_E_TOPO_CODEC_NOT_FOUND;
    }

    // Create the first encoder in the list.

    if (SUCCEEDED(hr))
    {
        hr = ppActivate[0]->ActivateObject(IID_PPV_ARGS(ppEncoder));
    }

    for (UINT32 i = 0; i < count; i++)
    {
        ppActivate[i]->Release();
    }
    CoTaskMemFree(ppActivate);

    return hr;
}

В следующем примере выполняется поиск аппаратного декодера видео с параметрами для включения асинхронных декодеров, аппаратных декодеров или декодеров перекодировки. В отличие от параллельного примера в статье MFTEnumEx , этот пример создает экземпляр IMFAttributes и задает для атрибута MFT_ENUM_ADAPTER_LUID значение LUID интерфейса, из которого запрашивается декодер видео. В вызове MFTEnum2 устанавливается обязательный флаг MFT_ENUM_FLAG_HARDWARE и предоставляется аргумент IMFAttributes .

HRESULT FindHWVideoDecoder(
    const GUID& subtype,
    BOOL bAllowAsync,
    BOOL bAllowHardware,
    BOOL bAllowTranscode,
    LUID& adapterLuid,          // LUID of the graphics adapter for which to find the encoder
    IMFTransform **ppDecoder
)
{
    HRESULT hr = S_OK;
    UINT32 count = 0;

    IMFActivate **ppActivate = NULL;

    MFT_REGISTER_TYPE_INFO info = { MFMediaType_Video, subtype };

    UINT32 unFlags = MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT |
        MFT_ENUM_FLAG_SORTANDFILTER;

    if (bAllowAsync)
    {
        unFlags |= MFT_ENUM_FLAG_ASYNCMFT;
    }
    if (bAllowHardware)
    {
        unFlags |= MFT_ENUM_FLAG_HARDWARE;
    }
    if (bAllowTranscode)
    {
        unFlags |= MFT_ENUM_FLAG_TRANSCODE_ONLY;
    }

    unFlags |= MFT_ENUM_FLAG_HARDWARE;

    CComPtr<IMFAttributes> spAttributes;
    hr = MFCreateAttributes(&spAttributes, 1);
    if (FAILED(hr = spAttributes->SetBlob(MFT_ENUM_ADAPTER_LUID, (BYTE*)&adapterLuid, sizeof(LUID))))
    {
        return hr;
    }

    hr = MFTEnumEx(MFT_CATEGORY_VIDEO_DECODER,
        unFlags,
        &info,      // Input type
        NULL,       // Output type
        &ppActivate,
        &count);

    if (SUCCEEDED(hr) && count == 0)
    {
        hr = MF_E_TOPO_CODEC_NOT_FOUND;
    }

    // Create the first decoder in the list.
    if (SUCCEEDED(hr))
    {
        hr = ppActivate[0]->ActivateObject(IID_PPV_ARGS(ppDecoder));
    }

    for (UINT32 i = 0; i < count; i++)
    {
        ppActivate[i]->Release();
    }
    CoTaskMemFree(ppActivate);

    return hr;
}

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	mfapi.h
Библиотека	Mfplat.lib
DLL	Mfplat.dll