IMFSourceReader ::SetStreamSelection, méthode (mfreadwrite.h)

Sélectionne ou désélectionne un ou plusieurs flux.

Syntaxe

HRESULT SetStreamSelection(
  [in] DWORD dwStreamIndex,
  [in] BOOL  fSelected
);

Paramètres

[in] dwStreamIndex

Flux à définir. La valeur peut être l’une des valeurs suivantes.

[in] fSelected

Spécifiez TRUE pour sélectionner des flux ou FALSE pour désélectionner des flux. Si un flux est désélectionné, il ne génère pas de données.

Valeur retournée

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

Remarques

Il existe deux utilisations courantes pour cette méthode :

• Pour modifier la sélection de flux par défaut. Certains fichiers multimédias contiennent plusieurs flux du même type. Par exemple, un fichier peut inclure des flux audio pour plusieurs langues. Vous pouvez utiliser cette méthode pour modifier les flux sélectionnés. Pour obtenir des informations sur chaque flux, appelez IMFSourceReader ::GetPresentationAttribute ou IMFSourceReader ::GetNativeMediaType.
• Si vous n’aurez pas besoin de données d’un des flux, il est judicieux de désélectionner ce flux. Si le flux est sélectionné, la source multimédia peut contenir une file d’attente de données non lues et la file d’attente peut croître indéfiniment, consommant de la mémoire.

Si un flux est désélectionné, la méthode IMFSourceReader ::ReadSample retourne MF_E_INVALIDREQUEST pour ce flux. D’autres méthodes IMFSourceReader sont valides pour les flux désélectionnés.

La sélection de flux n’affecte pas la façon dont le lecteur source charge ou décharge les décodeurs en mémoire. En particulier, la désélection d’un flux ne force pas le lecteur source à décharger le décodeur pour ce flux.

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

Spécifications

Voir aussi

IMFSourceReader

Lecteur source