Partager via

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

  • Article

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