MFRegisterLocalByteStreamHandler-Funktion (mfapi.h)

Registriert einen Byte-Stream-Handler im Prozess des Aufrufers.

Syntax

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

Parameter

[in] szFileExtension

Eine Zeichenfolge, die die Dateinamenerweiterung für diesen Handler enthält.

[in] szMimeType

Eine Zeichenfolge, die den MIME-Typ für diesen Handler enthält.

[in] pActivate

Ein Zeiger auf die IMFActivate-Schnittstelle eines Aktivierungsobjekts. Der Aufrufer implementiert diese Schnittstelle. Die IMFActivate::ActivateObject-Methode des Aktivierungsobjekts muss einen Bytestreamhandler erstellen. Der byte-stream-Handler macht die IMFByteStreamHandler-Schnittstelle verfügbar.

Rückgabewert

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

Hinweise

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

Innerhalb eines Prozesses haben lokale Byte-Stream-Handler Vorrang vor Byte-Stream-Handlern, die in der Registrierung registriert sind. Lokale Bytestreamhandler sind für andere Prozesse nicht sichtbar.

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

Entweder szFileExtension oder szMimeType kann NULL sein. mindestens eine muss nicht NULL sein.

Anforderungen

Weitere Informationen

Media Foundation-Funktionen

Schemahandler und Byte-Stream Handler