MFRegisterLocalSchemeHandler-Funktion (mfapi.h)

Artikel
03/01/2024

Registriert einen Schemahandler im Prozess des Aufrufers.

Syntax

HRESULT MFRegisterLocalSchemeHandler(
  [in] PCWSTR      szScheme,
  [in] IMFActivate *pActivate
);

Parameter

[in] szScheme

Eine Zeichenfolge, die das Schema enthält. Das Schema umfasst das nachfolgende ":"-Zeichen; beispiel: "http:".

[in] pActivate

Ein Zeiger auf die IMFActivate-Schnittstelle eines Aktivierungsobjekts. Der Aufrufer implementiert diese Schnittstelle. Die IMFActivate::ActivateObject-Methode des Aktivierungsobjekts muss ein Schemahandlerobjekt erstellen. Der Schemahandler macht die IMFSchemeHandler-Schnittstelle verfügbar.

Rückgabewert

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

Hinweise

Schemahandler werden in Microsoft Media Foundation während des Quellauflösungsprozesses verwendet, bei dem eine Medienquelle aus einer URL erstellt wird. Weitere Informationen finden Sie unter Schemahandler und Byte-Stream Handler.

Innerhalb eines Prozesses haben lokale Schemahandler Vorrang vor Schemahandlern, die in der Registrierung registriert sind. Lokale Schemahandler sind für andere Prozesse nicht sichtbar.

Verwenden Sie diese Funktion, wenn Sie einen benutzerdefinierten Schemahandler für Ihre Anwendung registrieren möchten, aber nicht möchten, dass der Handler für andere Anwendungen verfügbar ist.

Anforderungen

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

Weitere Informationen

MFRegisterLocalByteStreamHandler

Media Foundation-Funktionen

Schemahandler und Byte-Stream Handler

Share via