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

Voir aussi

MFRegisterLocalByteStreamHandler

Fonctions Media Foundation

Gestionnaires de schémas et gestionnaires de Byte-Stream