MFTGetInfo-Funktion (mfapi.h)
Ruft Informationen aus der Registrierung zu einer Media Foundation-Transformation (MFT) ab.
Syntax
HRESULT MFTGetInfo(
[in] CLSID clsidMFT,
[out] LPWSTR *pszName,
[out] MFT_REGISTER_TYPE_INFO **ppInputTypes,
[out] UINT32 *pcInputTypes,
[out] MFT_REGISTER_TYPE_INFO **ppOutputTypes,
[out] UINT32 *pcOutputTypes,
[out] IMFAttributes **ppAttributes
);
Parameter
[in] clsidMFT
Die CLSID des MFT.
[out] pszName
Empfängt einen Zeiger auf eine Breitzeichenzeichenfolge, die den Anzeigenamen des MFT enthält. Der Aufrufer muss die Zeichenfolge durch Aufrufen von CoTaskMemFree freigeben. Dieser Parameter kann NULL sein.
[out] ppInputTypes
Empfängt einen Zeiger auf ein Array von MFT_REGISTER_TYPE_INFO Strukturen. Jeder Member des Arrays beschreibt ein Eingabeformat, das vom MFT unterstützt wird. Der Aufrufer muss das Array durch Aufrufen von CoTaskMemFree freigeben. Dieser Parameter kann NULL sein.
[out] pcInputTypes
Empfängt die Anzahl der Elemente im ppInputTypes-Array . Wenn ppInputTypesNULL ist, wird dieser Parameter ignoriert und kann NULL sein.
[out] ppOutputTypes
Empfängt einen Zeiger auf ein Array von MFT_REGISTER_TYPE_INFO Strukturen. Jeder Member des Arrays beschreibt ein Ausgabeformat, das vom MFT unterstützt wird. Der Aufrufer muss das Array durch Aufrufen von CoTaskMemFree freigeben. Dieser Parameter kann NULL sein.
[out] pcOutputTypes
Empfängt die Anzahl der Elemente im ppOutputType-Array . Wenn ppOutputTypesNULL ist, wird dieser Parameter ignoriert und kann NULL sein.
[out] ppAttributes
Empfängt einen Zeiger auf die IMFAttributes-Schnittstelle eines Attributspeichers . Der Aufrufer muss die Schnittstelle freigeben. Der Attributspeicher kann Attribute enthalten, die in der Registrierung für den angegebenen MFT gespeichert sind. (Weitere Informationen finden Sie unter MFTRegister.) Wenn keine Attribute in der Registrierung für diesen MFT gespeichert werden, ist der Attributspeicher leer.
Dieser Parameter kann NULL sein.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfapi.h |
| Bibliothek | Mfplat.lib |
| DLL | Mfplat.dll |