auxGetDevCapsA, fonction (mmeapi.h)

  • Article

La fonction auxGetDevCaps récupère les fonctionnalités d’un périphérique de sortie auxiliaire donné.

Syntaxe

MMRESULT auxGetDevCapsA(
  UINT_PTR   uDeviceID,
  LPAUXCAPSA pac,
  UINT       cbac
);

Paramètres

uDeviceID

Identificateur du périphérique de sortie auxiliaire à interroger. Spécifiez un identificateur d’appareil valide (voir la section commentaires suivante) ou utilisez la constante suivante :

Valeur Signification
AUX_MAPPER Mappeur audio auxiliaire. La fonction retourne une erreur si aucun mappeur audio auxiliaire n’est installé.

pac

Pointeur vers une structure AUXCAPS à remplir avec des informations sur les fonctionnalités de l’appareil.

cbac

Taille, en octets, de la structure AUXCAPS .

Valeur retournée

Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour Description
MMSYSERR_BADDEVICEID
 L’identificateur d’appareil spécifié est hors limites.

Notes

L’identificateur d’appareil dans uDeviceID varie de zéro à un de moins que le nombre d’appareils présents. AUX_MAPPER peuvent également être utilisés. Utilisez la fonction auxGetNumDevs pour déterminer le nombre de périphériques de sortie auxiliaires présents dans le système.

Notes

L’en-tête mmeapi.h définit auxGetDevCaps comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mmeapi.h (inclure Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Waveform Audio

Fonctions de forme d’onde