Méthode IMFSourceReader ::GetNativeMediaType (mfreadwrite.h)

Article
03/01/2024

Obtient un format pris en charge en mode natif par la source multimédia.

Syntaxe

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Paramètres

[in] dwStreamIndex

Spécifie le flux à interroger. La valeur peut être l’une des valeurs 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] dwMediaTypeIndex

Spécifie le type de média à interroger. La valeur peut être l’une des valeurs suivantes.

Valeur	Signification
0 à 0xFFFFFFFE	Index de base zéro d’un type de média
MF_SOURCE_READER_CURRENT_TYPE_INDEX 0xFFFFFFFF	Type de média natif actuel.

[out] ppMediaType

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

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
MF_E_INVALIDSTREAMNUMBER	Le paramètre dwStreamIndex n’est pas valide.
MF_E_NO_MORE_TYPES	Le paramètre dwMediaTypeIndex est hors limites.

Remarques

Cette méthode interroge la source multimédia sous-jacente pour son format de sortie natif. Potentiellement, chaque flux source peut produire plusieurs formats de sortie. Utilisez le paramètre dwMediaTypeIndex pour parcourir en boucle les formats disponibles. En règle générale, les sources de fichiers n’offrent qu’un seul format par flux, mais les appareils de capture peuvent en proposer plusieurs.

La méthode retourne une copie du type de média. Il est donc sûr de modifier l’objet reçu dans le paramètre ppMediaType .

Pour définir le type de sortie d’un flux, appelez la méthode IMFSourceReader ::SetCurrentMediaType .

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

IMFSourceReader

Lecteur source

Partager via