MFTEnum2-Funktion (mfapi.h)
Ruft eine Liste von Microsoft Media Foundation-Transformationen (MFTs) ab, die den angegebenen Suchkriterien entsprechen. Diese Funktion erweitert die MFTEnumEx-Funktion , damit externe Anwendungen und interne Komponenten die Hardware-MFTs ermitteln können, die einem bestimmten Grafikkarten entsprechen.
Syntax
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
);
Parameter
[in] guidCategory
Eine GUID, die die Kategorie der aufzuzählenden MFTs angibt. Eine Liste der MFT-Kategorien finden Sie unter MFT_CATEGORY.
[in] Flags
Das bitweise OR von null oder mehr Flags aus der _MFT_ENUM_FLAG-Enumeration .
[in] pInputType
Ein Zeiger auf eine MFT_REGISTER_TYPE_INFO-Struktur , die einen zu übereinstimmenden Eingabemedientyp angibt.
Dieser Parameter kann NULL sein. Bei NULL werden alle Eingabetypen abgeglichen.
[in] pOutputType
Ein Zeiger auf eine MFT_REGISTER_TYPE_INFO-Struktur , die einen Ausgabemedientyp angibt, der übereinstimmen soll.
Dieser Parameter kann NULL sein. Bei NULL werden alle Ausgabetypen abgeglichen.
[in, optional] pAttributes
Ein Zeiger auf eine IMFAttributes-Schnittstelle , die den Zugriff auf den Standardattributspeicher ermöglicht. Um einen bestimmten Hardwareadapter anzugeben, für den MFTs abgefragt werden, legen Sie das attribut MFT_ENUM_ADAPTER_LUID auf die LUID des Adapters fest. Wenn Sie dies tun, müssen Sie auch das MFT_ENUM_FLAG_HARDWARE-Flag angeben, oder E_INVALIDARG zurückgegeben wird.
[out] pppMFTActivate
Empfängt ein Array von IMFActivate-Schnittstellenzeigern . Jeder Zeiger stellt ein Aktivierungsobjekt für einen MFT dar, das den Suchkriterien entspricht. Die Funktion weist den Arbeitsspeicher für das Array zu. Der Aufrufer muss die Zeiger freigeben und die CoTaskMemFree-Funktion aufrufen, um den Arbeitsspeicher für das Array freizugeben.
[out] pnumMFTActivate
Empfängt die Anzahl der Elemente im pppMFTActivate-Array . Wenn keine MFTs den Suchkriterien entsprechen, erhält dieser Parameter den Wert 0.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Im pAttributes-Parameter wurde ein IMFAttributes-Attribut mit dem MFT_ENUM_ADAPTER_LUID-Attribut bereitgestellt, und das MFT_ENUM_FLAG_HARDWARE-Flag wurde nicht angegeben. |
Hinweise
Der Flags-Parameter steuert, welche MFTs aufgelistet werden, und die Reihenfolge, in der sie zurückgegeben werden. Die Flags für diesen Parameter sind in mehrere Gruppen unterteilt.
Der erste Satz von Flags gibt an, wie ein MFT Daten verarbeitet.
| Flag | Beschreibung |
|---|---|
| MFT_ENUM_FLAG_SYNCMFT | Die MFT führt synchrone Datenverarbeitung in Software durch. Dies ist das ursprüngliche MFT-Verarbeitungsmodell und mit Windows Vista kompatibel. |
| MFT_ENUM_FLAG_ASYNCMFT | Die MFT führt asynchrone Datenverarbeitung in Software durch. Für dieses Verarbeitungsmodell ist Windows 7 erforderlich. Weitere Informationen finden Sie unter Asynchrone MFTs. |
| MFT_ENUM_FLAG_HARDWARE |
Der MFT führt hardwarebasierte Datenverarbeitung durch, wobei entweder der AVStream-Treiber oder ein GPU-basiertes Proxy-MFT verwendet wird. MFTs in dieser Kategorie verarbeiten Daten immer asynchron. Weitere Informationen finden Sie unter Hardware-MFTs.
Hinweis Wenn im pAttributes-Parameter ein IMFAttributes-Attribut mit dem MFT_ENUM_ADAPTER_LUID-Attribut angegeben wird, muss das MFT_ENUM_FLAG_HARDWARE-Flag festgelegt werden, damit E_INVALIDARG zurückgegeben wird.
|
Jede MFT fällt genau in eine dieser Kategorien. Um eine Kategorie aufzulisten, legen Sie das entsprechende Flag im Flags-Parameter fest. Sie können diese Flags kombinieren, um mehrere Kategorien aufzulisten. Wenn keines dieser Flags angegeben ist, ist die Standardkategorie synchrone MFTs (MFT_ENUM_FLAG_SYNCMFT).
Als Nächstes enthalten die folgenden Flags MFTs, die andernfalls von den Ergebnissen ausgeschlossen werden. Standardmäßig werden Flags, die diesen Kriterien entsprechen, von den Ergebnissen ausgeschlossen. Verwenden Sie diese Flags, um sie einzuschließen.
| Flag | Beschreibung |
|---|---|
| MFT_ENUM_FLAG_FIELDOFUSE | Schließen Sie MFTs ein, die von der Anwendung entsperrt werden müssen. |
| MFT_ENUM_FLAG_LOCALMFT | Schließen Sie MFTs ein, die im Prozess des Aufrufers über die Funktion MFTRegisterLocal oder MFTRegisterLocalByCLSID registriert sind. |
| MFT_ENUM_FLAG_TRANSCODE_ONLY | Schließen Sie MFTs ein, die für die Transcodierung und nicht für die Wiedergabe optimiert sind. |
Das letzte Flag wird verwendet, um die Ergebnisse zu sortieren und zu filtern:
| Flag | Beschreibung |
|---|---|
| MFT_ENUM_FLAG_SORTANDFILTER | Sortieren und filtern Sie die Ergebnisse. |
Wenn das MFT_ENUM_FLAG_SORTANDFILTER-Flag festgelegt ist, sortiert die MFTEnum2-Funktion die Ergebnisse wie folgt:
- Lokal: Wenn das flag MFT_ENUM_FLAG_LOCALMFT festgelegt ist, werden lokale MFTs zuerst in der Liste angezeigt. Um einen lokalen MFT zu registrieren, rufen Sie die Funktion MFTRegisterLocal oder MFTRegisterLocalByCLSID auf.
- Verdienst: MFTs mit einem Verdienstwert werden als nächstes in der Liste in der Reihenfolge des Verdienstwerts (höchster bis niedrigster Wert) angezeigt. Weitere Informationen zum Verdienst finden Sie unter MFT_CODEC_MERIT_Attribute.
- Bevorzugt: Wenn ein MFT in der bevorzugten Liste des Plug-In-Steuerelements aufgeführt ist, wird er als Nächstes in der Liste angezeigt. Weitere Informationen zum Plug-In-Steuerelement finden Sie unter IMFPluginControl.
- Wenn ein MFT in der Blockierten Liste angezeigt wird, wird er von den Ergebnissen ausgeschlossen. Weitere Informationen zur Blockierten Liste finden Sie unter IMFPluginControl::IsDisabled.
- Alle anderen MFTs, die den Suchkriterien entsprechen, werden unsortiert am Ende der Liste angezeigt.
Das Festlegen des Flags-Parameters auf 0 entspricht der Verwendung des Werts MFT_ENUM_FLAG_SYNCMFT | MFT_ENUM_FLAG_LOCALMFT | MFT_ENUM_FLAG_SORTANDFILTER.
Das Festlegen von Flags auf MFT_ENUM_FLAG_SYNCMFT entspricht dem Aufrufen der MFTEnum-Funktion .
Wenn keine MFTs den Suchkriterien entsprechen, gibt die Funktion S_OK zurück, es sei denn, es tritt ein anderer Fehler auf. Überprüfen Sie daher immer die anzahl, die im pcMFTActivate-Parameter empfangen wurde, bevor Sie den pppMFTActivate-Zeiger ableiten.
Erstellen des MFT
Wenn mindestens ein MFT den Suchkriterien entspricht, empfängt der parameter pppMFTActivate ein Array von IMFActivate-Zeigern . Für jeden übereinstimmenden MFT wird ein Zeiger zurückgegeben. Jeder Zeiger stellt ein Aktivierungsobjekt für den MFT dar. Weitere Informationen finden Sie unter Aktivierungsobjekte.Zusätzliche Informationen zu jedem MFT werden als Attribute für die Aktivierungsobjekte gespeichert. Eine Liste der möglichen Attribute finden Sie unter Transform Attributes.
Um eine instance des MFT zu erstellen, rufen Sie IMFActivate::ActivateObject auf.
Hardwarecodecs
Hardwarecodecs werden von den Enumerationsergebnissen ausgeschlossen, wenn die folgenden Registrierungsschlüssel auf 0 festgelegt sind:Decoder: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\HardwareMFT\EnableDecoder
Encoder: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\HardwareMFT\EnableEncoders
Videoprozessoren: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Media Foundation\HardwareMFT\EnableVideoProcessors
Diese Schlüssel sind für OEMs vorgesehen und sollten nicht von Anwendungen verwendet werden.
Für Hardwarecodecs kann der guidCategory-Parameter von MFTEnum2 auch eine der folgenden KS-Gerätekategorien (Kernel streaming) angeben:
- KSCATEGORY_DATACOMPRESSOR
- KSCATEGORY_DATADECOMPRESSOR
Beispiele
Das folgende Beispiel ruft den ersten verfügbaren IDXGIAdapter1 ab und ruft die Adapter-LUID ab, die zum Identifizieren des Adapters für die nachfolgenden Beispiele erforderlich ist.
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;
Im folgenden Beispiel wird nach einem Hardwarevideo- oder Audiodecoder gesucht. Asynchrone Decoder, Hardware- und Transcodierungsdecoder sind ausgeschlossen. Wenn eine Übereinstimmung gefunden wird, erstellt der Code das erste MFT in der Liste. Im Gegensatz zum parallelen Beispiel im MFTEnumEx-Artikel erstellt dieses Beispiel eine instance von IMFAttributes und legt das attribut MFT_ENUM_ADAPTER_LUID auf die LUID der Schnittstelle fest, von der der Decoder angefordert wird. Beim Aufruf von MFTEnum2 wird das erforderliche MFT_ENUM_FLAG_HARDWARE-Flag festgelegt, und das IMFAttributes-Argument wird bereitgestellt.
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;
}
Im nächsten Beispiel wird nach einem Hardwarevideo- oder Audioencoder gesucht. Asynchrone Encoder, Hardware-, Transcodierungs- und Field-of-Use-Encoder sind ausgeschlossen. Im Gegensatz zum parallelen Beispiel im MFTEnumEx-Artikel erstellt dieses Beispiel eine instance von IMFAttributes und legt das attribut MFT_ENUM_ADAPTER_LUID auf die LUID der Schnittstelle fest, von der der Encoder angefordert wird. Beim Aufruf von MFTEnum2 wird das erforderliche MFT_ENUM_FLAG_HARDWARE-Flag festgelegt, und das IMFAttributes-Argument wird bereitgestellt.
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;
}
Im nächsten Beispiel wird nach einem Hardware-Videodecoder mit Optionen gesucht, die asynchrone Decoder, Hardware- oder Transcodierungsdecoder einschließen können. Im Gegensatz zum parallelen Beispiel im MFTEnumEx-Artikel erstellt dieses Beispiel eine instance von IMFAttributes und legt das attribut MFT_ENUM_ADAPTER_LUID auf die LUID der Schnittstelle fest, von der der Videodecoder angefordert wird. Beim Aufruf von MFTEnum2 wird das erforderliche MFT_ENUM_FLAG_HARDWARE-Flag festgelegt, und das IMFAttributes-Argument wird bereitgestellt.
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;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfapi.h |
| Bibliothek | Mfplat.lib |
| DLL | Mfplat.dll |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für