Méthode IAudioEndpointVolume ::QueryHardwareSupport (endpointvolume.h)

  • Article

La méthode QueryHardwareSupport interroge le périphérique de point de terminaison audio pour ses fonctions matérielles prises en charge.

Syntaxe

HRESULT QueryHardwareSupport(
  [out] DWORD *pdwHardwareSupportMask
);

Paramètres

[out] pdwHardwareSupportMask

Pointeur vers une variable DWORD dans laquelle la méthode écrit un masque de prise en charge matérielle qui indique les fonctionnalités matérielles du périphérique de point de terminaison audio. La méthode peut définir le masque sur 0 ou sur la combinaison au niveau du bit-OR d’une ou plusieurs constantes ENDPOINT_HARDWARE_SUPPORT_XXX .

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
E_POINTER
 Le paramètre pdwHardwareSupportMask a la valeur NULL.

Remarques

Cette méthode indique si le périphérique de point de terminaison audio implémente les fonctions suivantes dans le matériel :

  • Contrôle du volume
  • Désactiver le contrôle
  • Compteur de pointe
Le système substitue automatiquement une implémentation logicielle à toute fonction de la liste précédente que l’appareil de point de terminaison n’implémente pas dans le matériel.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête endpointvolume.h

Voir aussi

IAudioEndpointVolume, interface