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
| 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 |