auxGetDevCapsW, fonction (mmeapi.h)
La fonction auxGetDevCaps récupère les fonctionnalités d’un périphérique de sortie auxiliaire donné.
Syntaxe
MMRESULT auxGetDevCapsW(
UINT_PTR uDeviceID,
LPAUXCAPSW pac,
UINT cbac
);
Paramètres
uDeviceID
Identificateur de l’appareil de sortie auxiliaire à interroger. Spécifiez un identificateur d’appareil valide (consultez 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 de retour
Retourne MMSYSERR_NOERROR en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Retourner le code | Description |
|---|---|
|
L’identificateur d’appareil spécifié est hors limites. |
Remarques
L’identificateur d’appareil dans uDeviceID varie de zéro à un nombre inférieur au nombre d’appareils présents. AUX_MAPPER peut également être utilisé. Utilisez la fonction auxGetNumDevs pour déterminer le nombre d’appareils de sortie auxiliaires présents dans le système.
Note
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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | mmeapi.h (include Windows.h) |
| bibliothèque | Winmm.lib |
| DLL | Winmm.dll |