Méthode IMFSinkWriter ::GetServiceForStream (mfreadwrite.h)

Article
02/28/2024

Interroge le récepteur multimédia ou l’encodeur sous-jacent pour une interface.

Syntaxe

HRESULT GetServiceForStream(
  [in]  DWORD   dwStreamIndex,
  [in]  REFGUID guidService,
  [in]  REFIID  riid,
  [out] LPVOID  *ppvObject
);

Paramètres

[in] dwStreamIndex

Index de base zéro d’un flux à interroger, ou MF_SINK_WRITER_MEDIASINK pour interroger le récepteur multimédia lui-même.

[in] guidService

GUID d’identificateur de service ou GUID_NULL. Si la valeur est GUID_NULL, la méthode appelle QueryInterface pour obtenir l’interface demandée. Sinon, la méthode appelle IMFGetService ::GetService. Pour obtenir la liste des identificateurs de service, consultez Interfaces de service.

[in] riid

Identificateur d’interface (IID) de l’interface demandée.

[out] ppvObject

Reçoit un pointeur vers l’interface demandée. L’appelant doit libérer l’interface.

Valeur retournée

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

Remarques

Si le paramètre dwStreamIndex est égal à MF_SINK_WRITER_MEDIASINK, la méthode tente d’obtenir l’interface à partir du récepteur multimédia. Sinon, il tente d’obtenir l’interface de l’encodeur pour le flux à l’index spécifié. En cas d’échec ou si aucun encodeur n’est présent, la méthode tente d’obtenir l’interface à partir du flux sur le récepteur multimédia.

Si les types d’entrée et de sortie du récepteur sont identiques et compressés, il est possible qu’aucun encodage ne soit requis et que l’encodeur vidéo ne soit pas instancié. Dans ce cas, GetServiceForStream retourne MF_E_UNSUPPORTED_SERVICE.

Cette interface est disponible sur Windows Vista si le Supplément de mise à jour de la plateforme pour Windows Vista est installé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista et supplément de mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	mfreadwrite.h

Voir aussi

IMFSinkWriter

Enregistreur de récepteurs

Partager via