Partager via


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