Méthode IMFASFProfile ::GetStream (wmcontainer.h)

Article
03/13/2024

Récupère un flux du profil par index de flux et/ou récupère le numéro de flux d’un index de flux.

Syntaxe

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Paramètres

[in] dwStreamIndex

Index du flux à récupérer. Stream index sont séquentiels et de base zéro. Vous pouvez obtenir le nombre de flux figurant dans le profil en appelant la méthode IMFASFProfile ::GetStreamCount .

[out] pwStreamNumber

Reçoit le numéro de flux du flux demandé. Stream nombres sont basés sur un et ne sont pas nécessairement séquentiels. Ce paramètre peut être défini sur NULL si le numéro de flux n’est pas requis.

[out] ppIStream

Reçoit un pointeur vers l’interface IMFASFStreamConfig de l’objet de configuration de flux ASF. L’appelant doit libérer l’interface. Ce paramètre peut être NULL si vous souhaitez récupérer le numéro de flux sans accéder à la configuration du flux.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

Cette méthode ne crée pas de copie de l’objet de configuration de flux. Le pointeur récupéré pointe vers l’objet dans l’objet de profil. Vous ne devez pas apporter de modifications à l’objet de configuration de flux à l’aide de ce pointeur, car cela peut affecter l’objet de profil de manière inattendue.

Pour modifier la configuration de l’objet de configuration de flux dans le profil, vous devez d’abord cloner l’objet de configuration de flux en appelant IMFASFStreamConfig ::Clone. Apportez les modifications requises au clone de l’objet, puis ajoutez l’objet mis à jour en appelant la méthode IMFASFProfile ::SetStream .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wmcontainer.h
Bibliothèque	Mfuuid.lib