Méthode IMFCaptureSource ::GetAvailableDeviceMediaType (mfcaptureengine.h)

Article
03/02/2024

Obtient un format pris en charge par l’un des flux de capture.

Syntaxe

HRESULT GetAvailableDeviceMediaType(
  [in] DWORD        dwSourceStreamIndex,
  [in] DWORD        dwMediaTypeIndex,
  [in] IMFMediaType **ppMediaType
);

Paramètres

[in] dwSourceStreamIndex

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

Valeur	Signification
0 à 0xFFFFFFFB	Index de base zéro d’un flux. Pour obtenir le nombre de flux, appelez IMFCaptureSource ::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	Premier flux d’image.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	Premier flux vidéo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	Premier flux audio.

[in] dwMediaTypeIndex

Index de base zéro du type de média à récupérer.

[in] ppMediaType

Reçoit un pointeur vers l’interface IMFMediaType . 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_INVALIDSTREAMNUMBER	Le paramètre dwSourceStreamIndex n’est pas valide.
MF_E_NO_MORE_TYPES	Le paramètre dwMediaTypeIndex est hors limites.

Remarques

Pour énumérer tous les formats disponibles sur un flux, appelez cette méthode dans une boucle tout en incrémentant dwMediaTypeIndex, jusqu’à ce que la méthode retourne MF_E_NO_MORE_TYPES.

Certaines caméras peuvent prendre en charge une plage de fréquences d’images. Les fréquences d’images minimales et maximales sont stockées dans les attributs MF_MT_FRAME_RATE_RANGE_MIN et MF_MT_FRAME_RATE_RANGE_MAX sur le type de média.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfcaptureengine.h

Voir aussi

IMFCaptureSource

Partager via