Fonction MFRegisterLocalSchemeHandler (mfapi.h)
Inscrit un gestionnaire de schéma dans le processus de l’appelant.
Syntaxe
HRESULT MFRegisterLocalSchemeHandler(
[in] PCWSTR szScheme,
[in] IMFActivate *pActivate
);
Paramètres
[in] szScheme
Chaîne qui contient le schéma. Le schéma inclut le caractère de fin « : » ; par exemple, « http : ».
[in] pActivate
Pointeur vers l’interface IMFActivate d’un objet d’activation. L’appelant implémente cette interface. La méthode IMFActivate ::ActivateObject de l’objet d’activation doit créer un objet gestionnaire de schéma. Le gestionnaire de schéma expose l’interface IMFSchemeHandler .
Valeur retournée
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Les gestionnaires de schémas sont utilisés dans Microsoft Media Foundation pendant le processus de résolution de la source, qui crée une source multimédia à partir d’une URL. Pour plus d’informations, consultez Gestionnaires de schémas et gestionnaires Byte-Stream.
Au sein d’un processus, les gestionnaires de schémas locaux sont prioritaires sur les gestionnaires de schémas inscrits dans le Registre. Les gestionnaires de schémas locaux ne sont pas visibles par les autres processus.
Utilisez cette fonction si vous souhaitez inscrire un gestionnaire de schéma personnalisé pour votre application, mais que vous ne souhaitez pas que le gestionnaire soit disponible pour d’autres applications.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mfapi.h |
| Bibliothèque | Mfplat.lib |
| DLL | Mfplat.dll |