Méthode IWMDMDevice2 ::GetFormatSupport2 (mswmdm.h)

Article
02/29/2024

La méthode GetFormatSupport2 récupère les formats pris en charge par l’appareil, notamment les codecs audio et vidéo et les formats de fichiers MIME.

Syntaxe

HRESULT GetFormatSupport2(
  [in]  DWORD              dwFlags,
  [out] _WAVEFORMATEX      **ppAudioFormatEx,
  [out] UINT               *pnAudioFormatCount,
  [out] _VIDEOINFOHEADER   **ppVideoFormatEx,
  [out] UINT               *pnVideoFormatCount,
  [out] WMFILECAPABILITIES **ppFileType,
  [out] UINT               *pnFileTypeCount
);

Paramètres

[in] dwFlags

DWORD spécifiant des formats audio, des formats vidéo et des types MIME. Cet indicateur spécifie ce que l’application demande au fournisseur de services de remplir. L’appelant peut définir une ou plusieurs des trois valeurs suivantes.

Valeur	Description
WMDM_GET_FORMAT_SUPPORT_AUDIO	Le fournisseur de services doit renseigner les paramètres audio.
WMDM_GET_FORMAT_SUPPORT_VIDEO	Le fournisseur de services doit remplir les paramètres vidéo.
WMDM_GET_FORMAT_SUPPORT_FILE	Le fournisseur de services doit remplir les paramètres de fichier.

[out] ppAudioFormatEx

Pointeur vers un tableau de structures _WAVEFORMATEX spécifiant des informations sur les codecs audio et les débits binaires pris en charge par l’appareil. La mémoire de ce paramètre est allouée par Windows Media Gestionnaire de périphériques et doit être libérée par l’appelant avec la fonction Win32 CoTaskMemFree.

[out] pnAudioFormatCount

Pointeur vers un entier spécifiant le nombre de formats audio.

[out] ppVideoFormatEx

Pointeur vers un tableau de structures _VIDEOFORMATEX spécifiant des informations sur les codes vidéo et les formats pris en charge par l’appareil. La mémoire de ce paramètre est allouée par Windows Media Gestionnaire de périphériques et doit être libérée par l’appelant avec la fonction Win32 CoTaskMemFree.

[out] pnVideoFormatCount

Pointeur vers un entier spécifiant le nombre de formats vidéo.

[out] ppFileType

Pointeur vers un tableau d’objets de type fichier WMFILECAPABILITIES . La mémoire de ce paramètre est allouée par Windows Media Gestionnaire de périphériques et doit être libérée par l’appelant avec la fonction Win32 CoTaskMemFree.

[out] pnFileTypeCount

Pointeur vers un entier spécifiant le nombre de types de fichiers.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Cette méthode étend IWMDMDevice ::GetFormatSupport pour gérer les formats vidéo. Toutefois, la méthode recommandée pour obtenir la prise en charge du format est IWMDMDevice3 ::GetFormatCapability. Si GetFormatCapability n’est pas pris en charge, l’appareil ne prendra probablement pas en charge la vidéo, et GetFormatSupport est probablement suffisant.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

Découverte des fonctionnalités de format d’appareil

IWMDMDevice2 Interface

IWMDMDevice3 ::GetFormatCapability

Partager via