Partager via


IMFSourceReaderEx ::GetTransformForStream, méthode (mfreadwrite.h)

Obtient un pointeur vers une transformation Media Foundation (MFT) pour un flux spécifié.

Syntaxe

HRESULT GetTransformForStream(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwTransformIndex,
  [out] GUID         *pGuidCategory,
  [out] IMFTransform **ppTransform
);

Paramètres

[in] dwStreamIndex

Flux à interroger pour le MFT. La valeur peut être l’une des valeurs suivantes.

Valeur Meaning
0 à 0xFFFFFFFB
Index de base zéro d’un flux.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
Premier flux vidéo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
Premier flux audio.

[in] dwTransformIndex

Index de base zéro du MFT à récupérer.

[out] pGuidCategory

Reçoit un GUID qui spécifie la catégorie du MFT. Pour obtenir la liste des valeurs possibles, consultez MFT_CATEGORY.

[out] ppTransform

Reçoit un pointeur vers l’interface IMFTransform du MFT. L’appelant doit libérer l’interface.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Descriptif
S_OK
Opération réussie.
MF_E_INVALIDINDEX
Le paramètre dwTransformIndex est hors plage.
MF_E_INVALIDSTREAMNUMBER
Le paramètre dwStreamIndex n’est pas valide.

Remarques

Vous pouvez utiliser cette méthode pour configurer un MFT une fois qu’il est inséré dans la chaîne de traitement. N’utilisez pas le pointeur retourné dans ppTransform pour définir des types de supports sur le MFT ou pour traiter les données. En particulier, l’appel de l’une des méthodes IMFTransform suivantes pourrait avoir des résultats inattendus.

Si un décodeur est présent, il apparaît à la position d’index zéro.

Pour éviter de perdre des données, vous devez vider le lecteur source avant d’appeler cette méthode. Pour plus d’informations, consultez Draining the Data Pipeline.

Spécifications

Requirement Valeur
Client minimum requis Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header mfreadwrite.h

Voir aussi

IMFSourceReaderEx