Fonction XInputGetAudioDeviceIds (xinput.h)

Récupère les ID de périphérique audio de rendu et de capture audio associés au casque connecté au contrôleur spécifié.

Syntaxe

DWORD XInputGetAudioDeviceIds(
  [in]                DWORD  dwUserIndex,
  [out, optional]     LPWSTR pRenderDeviceId,
  [in, out, optional] UINT   *pRenderCount,
  [out, optional]     LPWSTR pCaptureDeviceId,
  [in, out, optional] UINT   *pCaptureCount
);

Paramètres

[in] dwUserIndex

Index du joueur associé à l’appareil.

[out, optional] pRenderDeviceId

Chaîne d’ID d’appareil Audio Windows Core pour le rendu (haut-parleurs).

[in, out, optional] pRenderCount

Taille, en caractères larges, de la mémoire tampon de chaîne d’ID de périphérique de rendu.

[out, optional] pCaptureDeviceId

Chaîne d’ID d’appareil Audio Windows Core pour la capture (microphone).

[in, out, optional] pCaptureCount

Taille, en caractères larges, de la mémoire tampon de chaîne d’ID d’appareil de capture.

Valeur retournée

Si la fonction récupère correctement les ID d’appareil pour le rendu et la capture, le code de retour est ERROR_SUCCESS.

Si aucun casque n’est connecté au contrôleur, la fonction récupère également ERROR_SUCCESS avec NULL comme valeurs pour pRenderDeviceId et pCaptureDeviceId.

Si le périphérique de port du contrôleur n’est pas physiquement connecté, la fonction retourne ERROR_DEVICE_NOT_CONNECTED.

Si la fonction échoue, elle retourne un code d’erreur Win32 valide.

Remarques

Les appelants doivent allouer la mémoire pour les mémoires tampons passées à XInputGetAudioDeviceIds. Les chaînes obtenues peuvent être de longueur arbitraire.

Configuration requise pour la plateforme

Spécifications

Voir aussi

API audio principales

Fonctions XInput

XInputGetDSoundAudioDeviceGuids