MFTRegisterLocalByCLSID-Funktion (mfapi.h)

  • Artikel

Registriert eine Media Foundation-Transformation (MFT) im Prozess des Aufrufers.

Syntax

HRESULT MFTRegisterLocalByCLSID(
  [in] REFCLSID                     clisdMFT,
  [in] REFGUID                      guidCategory,
  [in] LPCWSTR                      pszName,
  [in] UINT32                       Flags,
  [in] UINT32                       cInputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pInputTypes,
  [in] UINT32                       cOutputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pOutputTypes
);

Parameter

[in] clisdMFT

Der Klassenbezeichner (CLSID) des MFT.

[in] guidCategory

Eine GUID, die die Kategorie des MFT angibt. Eine Liste der MFT-Kategorien finden Sie unter MFT_CATEGORY.

[in] pszName

Eine Zeichenfolge mit breitem NULL-Abschluss, die den Anzeigenamen des MFT enthält.

[in] Flags

Ein bitweiser OR mit null oder mehr Flags aus der _MFT_ENUM_FLAG-Enumeration .

[in] cInputTypes

Die Anzahl der Elemente im pInputTypes-Array .

[in] pInputTypes

Ein Zeiger auf ein Array von MFT_REGISTER_TYPE_INFO Strukturen. Jedes Element des Arrays gibt ein Eingabeformat an, das vom MFT unterstützt wird. Dieser Parameter kann NULL sein, wenn cInputTypes null ist.

[in] cOutputTypes

Die Anzahl der Elemente im pOutputTypes-Array .

[in] pOutputTypes

Ein Zeiger auf ein Array von MFT_REGISTER_TYPE_INFO Strukturen. Jedes Element des Arrays definiert ein Ausgabeformat, das vom MFT unterstützt wird. Dieser Parameter kann NULL sein, wenn cOutputTypes null ist.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Hauptzweck dieser Funktion besteht darin, einen MFT für die automatische Topologieauflösung verfügbar zu machen, ohne den MFT für andere Prozesse oder Anwendungen verfügbar zu machen.

Nachdem Sie diese Funktion aufgerufen haben, kann der MFT aufgezählt werden, indem die MFTEnumEx-Funktion mit dem flag MFT_ENUM_FLAG_LOCALMFT aufgerufen wird. Der MFT kann innerhalb desselben Prozesses aufgezählt werden, ist aber für andere Prozesse nicht sichtbar.

Um die Registrierung des MFT aus dem aktuellen Prozess aufzuheben, rufen Sie MFTUnregisterLocalByCLSID auf.

Wenn Sie einen MFT im PMP-Prozess (Protected Media Path) registrieren müssen, verwenden Sie die IMFLocalMFTRegistration-Schnittstelle .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

MFTRegisterLocal

Media Foundation-Funktionen