Funzione MFRegisterLocalSchemeHandler (mfapi.h)
Registra un gestore dello schema nel processo del chiamante.
Sintassi
HRESULT MFRegisterLocalSchemeHandler(
[in] PCWSTR szScheme,
[in] IMFActivate *pActivate
);
Parametri
[in] szScheme
Stringa che contiene lo schema. Lo schema include il carattere ':' finale; ad esempio "http:".
[in] pActivate
Puntatore all'interfaccia FMActivate di un oggetto di attivazione. Il chiamante implementa questa interfaccia. Il metodo IMFActivate::ActivateObject dell'oggetto di attivazione deve creare un oggetto gestore dello schema. Il gestore dello schema espone l'interfaccia IMFSchemeHandler .
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
I gestori di schemi vengono usati in Microsoft Media Foundation durante il processo di risoluzione di origine, che crea un'origine multimediale da un URL. Per altre informazioni, vedere Gestori schemi e gestori Byte-Stream.
All'interno di un processo, i gestori di schemi locali hanno la precedenza sui gestori di schemi registrati nel Registro di sistema. I gestori di schemi locali non sono visibili ad altri processi.
Usare questa funzione se si vuole registrare un gestore di schemi personalizzato per l'applicazione, ma non si vuole che il gestore sia disponibile per altre applicazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mfapi.h |
| Libreria | Mfplat.lib |
| DLL | Mfplat.dll |