Méthode IMFSourceReaderEx ::GetTransformForStream (mfreadwrite.h)

Article
02/28/2024

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 suivantes.

Valeur	Signification
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 de la 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	Description
S_OK	Réussite.
MF_E_INVALIDINDEX	Le paramètre dwTransformIndex est hors de portée.
MF_E_INVALIDSTREAMNUMBER	Le paramètre dwStreamIndex n’est pas valide.

Remarques

Vous pouvez utiliser cette méthode pour configurer un MFT après son insertion dans la chaîne de traitement. N’utilisez pas le pointeur retourné dans ppTransform pour définir des types de média sur le MFT ou pour traiter des 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 Drainage du pipeline de données.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	mfreadwrite.h

Voir aussi

IMFSourceReaderEx

Partager via