Fonction MFRegisterLocalByteStreamHandler (mfapi.h)

Article
02/28/2024

Inscrit un gestionnaire de flux d’octets dans le processus de l’appelant.

Syntaxe

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

Paramètres

[in] szFileExtension

Chaîne qui contient l’extension de nom de fichier pour ce gestionnaire.

[in] szMimeType

Chaîne qui contient le type MIME pour ce gestionnaire.

[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 gestionnaire de flux d’octets. Le gestionnaire de flux d’octets expose l’interface IMFByteStreamHandler .

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les gestionnaires de flux d’octets sont utilisés dans Microsoft Media Foundation pendant le processus de résolution source, qui crée une source multimédia à partir d’une URL. Pour plus d’informations, consultez Gestionnaires de schémas et gestionnaires de Byte-Stream.

Au sein d’un processus, les gestionnaires de flux d’octets locaux sont prioritaires sur les gestionnaires de flux d’octets inscrits dans le Registre. Les gestionnaires de flux d’octets locaux ne sont pas visibles par les autres processus.

Utilisez cette fonction si vous souhaitez inscrire un gestionnaire de flux d’octets personnalisé pour votre application, mais que vous ne souhaitez pas que le gestionnaire soit disponible pour d’autres applications.

szFileExtension ou szMimeType peut avoir la valeur NULL ; au moins un doit être non NULL.

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

Fonctions Media Foundation

Gestionnaires de schémas et gestionnaires de Byte-Stream

Share via