Share via

MÉTHODE IMFPMediaItem ::SetStreamSink (mfplay.h)

  • Article
Important Déconseillée. Cette API peut être supprimée des versions ultérieures de Windows. Les applications doivent utiliser la session multimédia pour la lecture.
 

Définit un récepteur multimédia pour l’élément multimédia. Un récepteur multimédia est un objet qui consomme les données d’un ou plusieurs flux.

Syntaxe

HRESULT SetStreamSink(
  [in] DWORD    dwStreamIndex,
  [in] IUnknown *pMediaSink
);

Paramètres

[in] dwStreamIndex

Index de base zéro d’un flux sur la source multimédia. Le récepteur multimédia reçoit les données de ce flux.

[in] pMediaSink

Pointeur IUnknown qui spécifie le récepteur de média. Passez l’une des opérations suivantes :

  • Pointeur vers un récepteur de flux. Chaque récepteur multimédia contient un ou plusieurs récepteurs de flux. Chaque récepteur de flux reçoit les données d’un flux. Le récepteur de flux doit exposer l’interface IMFStreamSink .
  • Pointeur vers un objet d’activation qui crée le récepteur multimédia. L’objet d’activation doit exposer l’interface IMFActivate . L’élément multimédia utilise le premier récepteur de flux sur le récepteur multimédia (autrement dit, le récepteur de flux à l’index 0).
  • NULL. Si vous définissez pMediaSink sur NULL, le récepteur de média par défaut pour le type de flux est utilisé.

Valeur retournée

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

Remarques

Par défaut, l’objet lecteur MFPlay restitue les flux audio vers le convertisseur audio en streaming (SAR) et les flux vidéo vers le convertisseur vidéo amélioré (EVR). Vous pouvez utiliser la méthode SetStreamSink pour fournir un autre récepteur multimédia pour un flux audio ou vidéo ; ou pour prendre en charge d’autres types de flux en plus de l’audio et de la vidéo. Vous pouvez également l’utiliser pour configurer le SAR ou l’EVR avant leur utilisation.

Appelez cette méthode avant d’appeler IMFPMediaPlayer ::SetMediaItem. L’appel de cette méthode après SetMediaItem n’a aucun effet, sauf si vous arrêtez la lecture et appelez à nouveau SetMediaItem .

Pour réinitialiser l’élément multimédia afin d’utiliser le récepteur multimédia par défaut, définissez pMediaSink sur NULL.

Optimisations de lecture à distance

Si l’application s’exécute sur le Bureau à distance et que vous appelez cette méthode avec une valeur non NULL pour un flux audio ou vidéo, MFPlay désactive les optimisations de lecture à distance. Cette remarque s’applique uniquement aux flux audio et vidéo. Elle ne s’applique pas aux flux qui contiennent un autre type de données, tel que du texte.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfplay.h

Voir aussi

IMFPMediaItem

Récepteurs multimédias

Utilisation de MFPlay pour la lecture audio/vidéo