Fonction MFRegisterLocalByteStreamHandler (mfapi.h)

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

Voir aussi

Fonctions Media Foundation

Gestionnaires de schémas et gestionnaires de Byte-Stream