MFTGetInfo-Funktion (mfapi.h)

  • Artikel

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

Weitere Informationen

MFTEnum

MFTRegister

Media Foundation-Funktionen

Media Foundation-Transformationen

Registrieren und Aufzählen von MFTs