MÉTHODE IMDSPDevice3 ::GetFormatCapability (mswmdm.h)

Article
03/06/2024

La méthode GetFormatCapability récupère à partir d’un appareil des informations sur les valeurs ou plages de valeurs prises en charge par l’appareil pour chaque aspect d’un format d’objet particulier.

Syntaxe

HRESULT GetFormatCapability(
  [in]  WMDM_FORMATCODE        format,
  [out] WMDM_FORMAT_CAPABILITY *pFormatSupport
);

Paramètres

[in] format

WMDM_FORMATCODE

Valeur énumérée représentant le format demandé.

[out] pFormatSupport

Retourné WMDM_FORMAT_CAPABILITY structure contenant les valeurs ou plages de valeurs prises en charge pour chaque aspect d’un format d’objet particulier.

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 suivantes de codes d’erreur :

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 peut être appelée pour n’importe quel format pris en charge. La liste des formats pris en charge est représentée par g_wszWMDMFormatsSupported propriété d’appareil .

Pour un format particulier, cette méthode doit retourner toutes les configurations des propriétés prises en charge (par exemple, des combinaisons de débit binaire et de taux d’échantillonnage). Ces informations sont exprimées sous la forme d’une fonctionnalité de format. Pour plus d’informations, consultez WMDM_FORMAT_CAPABILITY.