Partager via

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

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 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] dwMediaTypeIndex

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

Valeur Meaning
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

La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Code de retour Descriptif
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 plage.

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 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 offrir plusieurs formats.

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 plateforme pour Windows Vista est installé.

Spécifications

Requirement Valeur
Client minimum requis Supplément Windows 7, Windows Vista et 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 Fenêtres
Header mfreadwrite.h

Voir aussi

IMFSourceReader

Lecteur source

  • Last updated on