MFRegisterLocalSchemeHandler-Funktion (mfapi.h)
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 |