MFTEnumEx 함수(mfapi.h)

아티클
03/15/2023

지정된 검색 조건과 일치하는 MFT(Microsoft Media Foundation 변환) 목록을 가져옵니다. 이 함수는 MFTEnum 함수를 확장합니다.

구문

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

매개 변수

[in] guidCategory

열거할 MFT의 범주를 지정하는 GUID입니다. MFT 범주 목록은 MFT_CATEGORY 참조하세요.

[in] Flags

_MFT_ENUM_FLAG 열거형에서 0개 이상의 플래그가 있는 비트 OR입니다.

[in] pInputType

일치시킬 입력 미디어 형식을 지정하는 MFT_REGISTER_TYPE_INFO 구조체에 대한 포인터입니다.

이 매개 변수는 NULL일 수 있습니다. NULL이면 모든 입력 형식이 일치합니다.

[in] pOutputType

일치시킬 출력 미디어 형식을 지정하는 MFT_REGISTER_TYPE_INFO 구조체에 대한 포인터입니다.

이 매개 변수는 NULL일 수 있습니다. NULL이면 모든 출력 형식이 일치합니다.

[out] pppMFTActivate

IMFActivate 인터페이스 포인터의 배열을 받습니다. 각 포인터는 검색 조건과 일치하는 MFT의 활성화 개체를 나타냅니다. 함수는 배열에 대한 메모리를 할당합니다. 호출자는 포인터를 해제하고 CoTaskMemFree 함수를 호출하여 배열에 대한 메모리를 해제해야 합니다.

[out] pnumMFTActivate

pppMFTActivate 배열의 요소 수를 받습니다. 검색 조건과 일치하는 MFT가 없으면 이 매개 변수는 값 0을 받습니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

Flags 매개 변수는 열거되는 MFT 및 반환되는 순서를 제어합니다. 이 매개 변수의 플래그는 여러 그룹으로 분류됩니다.

첫 번째 플래그 집합은 MFT가 데이터를 처리하는 방법을 지정합니다.

플래그	설명
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를 참조하세요.

모든 MFT는 정확히 이러한 범주 중 하나에 속합니다. 범주를 열거하려면 Flags 매개 변수에서 해당 플래그를 설정합니다. 이러한 플래그를 결합하여 둘 이상의 범주를 열거할 수 있습니다. 이러한 플래그를 지정하지 않으면 기본 범주는 동기 MFT(MFT_ENUM_FLAG_SYNCMFT)입니다.

다음으로, 다음 플래그에는 결과에서 제외되는 MFT가 포함됩니다. 기본적으로 이러한 조건과 일치하는 플래그는 결과에서 제외됩니다. 이러한 플래그를 사용하여 플래그를 포함합니다.

플래그	설명
MFT_ENUM_FLAG_FIELDOFUSE	애플리케이션에서 잠금 해제해야 하는 MFT를 포함합니다.
MFT_ENUM_FLAG_LOCALMFT	MFTRegisterLocal 또는 MFTRegisterLocalByCLSID 함수를 통해 호출자의 프로세스에 등록된 MFT를 포함합니다.
MFT_ENUM_FLAG_TRANSCODE_ONLY	재생보다는 코드 변환에 최적화된 MFT를 포함합니다.

마지막 플래그는 결과를 정렬하고 필터링하는 데 사용됩니다.

플래그	설명
MFT_ENUM_FLAG_SORTANDFILTER	결과를 정렬하고 필터링합니다.

MFT_ENUM_FLAG_SORTANDFILTER 플래그가 설정된 경우 MFTEnumEx 함수는 다음과 같이 결과를 정렬합니다.

로컬: MFT_ENUM_FLAG_LOCALMFT 플래그가 설정된 경우 로컬 MFT가 목록에 먼저 표시됩니다. 로컬 MFT를 등록하려면 MFTRegisterLocal 또는 MFTRegisterLocalByCLSID 함수를 호출합니다.
장점: 장점 값이 있는 MFT는 장점 값(가장 높음에서 가장 낮은 값)의 순서로 목록 옆에 표시됩니다. 장점에 대한 자세한 내용은 MFT_CODEC_MERIT_Attribute 참조하세요.
기본 설정: MFT가 플러그 인 컨트롤의 기본 설정 목록에 나열되면 목록의 다음으로 표시됩니다. 플러그 인 제어에 대한 자세한 내용은 IMFPluginControl을 참조하세요.
MFT가 차단된 목록에 표시되면 결과에서 제외됩니다. 차단된 목록에 대한 자세한 내용은 IMFPluginControl::IsDisabled를 참조하세요.
검색 조건과 일치하는 다른 모든 MFT는 목록의 끝에 정렬되지 않은 상태로 표시됩니다.

MFT_ENUM_FLAG_SORTANDFILTER 플래그를 설정하지 않으면 MFTEnumEx 함수는 정렬되지 않은 목록을 반환합니다.

Flags 매개 변수를 0으로 설정하는 것은 값 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의 instance 만들려면 IMFActivate::ActivateObject를 호출합니다.

하드웨어 코덱

다음 레지스트리 키가 0으로 설정된 경우 하드웨어 코덱은 열거형 결과에서 제외됩니다.

디코더: 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

이러한 키는 OEM을 위한 것이며 애플리케이션에서 사용하면 안 됩니다.

하드웨어 코덱의 경우 MFTEnumEx의 guidCategory 매개 변수는 다음 KS(커널 스트리밍) 디바이스 범주 중 하나를 지정할 수도 있습니다.

KSCATEGORY_DATACOMPRESSOR
KSCATEGORY_DATADECOMPRESSOR

하드웨어 코덱도 MFT_CATEGORY GUID로 등록해야 하므로 애플리케이션은 일반적으로 KS 디바이스 범주 대신 해당 범주를 사용해야 합니다.

예제

다음 예제에서는 비디오 또는 오디오 디코더를 검색합니다. 비동기, 하드웨어, 트랜스코드 및 사용 필드 디코더는 제외됩니다. 일치 항목이 발견되면 코드는 목록에서 첫 번째 MFT를 만듭니다.

HRESULT FindDecoderEx(
    const GUID& subtype,        // Subtype
    BOOL bAudio,                // TRUE for audio, FALSE for video
    IMFTransform **ppDecoder    // Receives a pointer to the decoder.
    )
{
    HRESULT hr = S_OK;
    UINT32 count = 0;

    IMFActivate **ppActivate = NULL;

    MFT_REGISTER_TYPE_INFO info = { 0 };

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

    hr = MFTEnumEx(
        bAudio ? MFT_CATEGORY_AUDIO_DECODER : MFT_CATEGORY_VIDEO_DECODER,
        MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT | MFT_ENUM_FLAG_SORTANDFILTER,
        &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;
}

다음 예제에서는 비디오 또는 오디오 인코더를 검색합니다. 비동기, 하드웨어, 트랜스코드 및 사용 필드 인코더는 제외됩니다.

HRESULT FindEncoderEx(
    const GUID& subtype,        // Subtype
    BOOL bAudio,                // TRUE for audio, FALSE for video
    IMFTransform **ppEncoder    // Receives a pointer to the decoder.
    )
{
    HRESULT hr = S_OK;
    UINT32 count = 0;

    IMFActivate **ppActivate = NULL;

    MFT_REGISTER_TYPE_INFO info = { 0 };

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

    hr = MFTEnumEx(
        bAudio ? MFT_CATEGORY_AUDIO_ENCODER : MFT_CATEGORY_VIDEO_ENCODER,
        MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT | MFT_ENUM_FLAG_SORTANDFILTER,
        NULL,       // Input type
        &info,      // Output type
        &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;
}

다음 예제에서는 비동기, 하드웨어 또는 트랜스코드 디코더를 포함하는 옵션을 사용하여 비디오 디코더를 검색합니다.

HRESULT FindVideoDecoder(
    const GUID& subtype,
    BOOL bAllowAsync,
    BOOL bAllowHardware, 
    BOOL bAllowTranscode,
    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;
    }

    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 7 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	mfapi.h
라이브러리	Mfplat.lib
DLL	Mfplat.dll