XInputGetAudioDeviceIds 函数 (xinput.h)

检索与连接到指定控制器的耳机关联的声音呈现和声音捕获音频设备 ID。

语法

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

参数

[in] dwUserIndex

与设备关联的玩家的索引。

[out, optional] pRenderDeviceId

用于呈现 (扬声器) 的 Windows Core 音频设备 ID 字符串。

[in, out, optional] pRenderCount

呈现设备 ID 字符串缓冲区的大小(以宽字符为单位)。

[out, optional] pCaptureDeviceId

用于捕获 (麦克风) 的 Windows Core 音频设备 ID 字符串。

[in, out, optional] pCaptureCount

捕获设备 ID 字符串缓冲区的大小(以宽字符为单位)。

返回值

如果函数成功检索用于呈现和捕获的设备 ID,则 返回代码ERROR_SUCCESS

如果没有头戴显示设备连接到控制器,则该函数还将检索 null 作为pRenderDeviceIdpCaptureDeviceId 的值的ERROR_SUCCESS

如果控制器端口设备未以物理方式连接,则函数将返回 ERROR_DEVICE_NOT_CONNECTED

如果该函数失败,它将返回有效的 Win32 错误代码。

注解

调用方必须为传递给 XInputGetAudioDeviceIds 的缓冲区分配内存。 生成的字符串长度可以是任意的。

平台要求

Windows 8 (XInput 1.4)

要求

   
目标平台 Windows
标头 xinput.h
Library Xinput.lib
DLL Xinput1_4.dll

另请参阅

核心音频 API

XInput 函数

XInputGetDSoundAudioDeviceGuids