通过

XInputGetAudioDeviceIds

  • 项目

注意

尚未实现此函数。

检索连接到指定控制器的头戴设备音频渲染器和采集设备 ID。

语法

DWORD XInputGetAudioDeviceIds( 
         DWORD dwUserIndex,​
         LPWSTR pRenderDeviceId,​
         UINT * pRenderCount,​
         LPWSTR pCaptureDeviceId,​
         UINT * pCaptureCount
)​

参数

dwUserIndex _In_
类型：DWORD

与头戴设备相关联的玩家的索引；介于 0 到 XUSER_MAX_COUNT - 1 之间的值。

pRenderDeviceId _Out_writes_opt_z_(*pRenderCount)
类型：LPWSTR

音频渲染器的 ID；即播放音频输出的设备，如耳机。

pRenderCount _Inout_opt_
类型：UINT*

渲染器设备字符串缓冲区的大小，以宽字符表示。

pCaptureDeviceId _Out_writes_opt_z_(*pCaptureCount)
类型：LPWSTR

音频采集设备的 ID；即采集音频输入的设备，如麦克风。

pCaptureCount _Inout_opt_
类型：UINT*

采集设备字符串缓冲区的大小，以宽字符表示。

返回值

类型：DWORD

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

如果没有任何头戴设备连接到控制器，该函数也会返回 ERROR_SUCCESS，并将 NULL 作为 pRenderDeviceId 和 pCaptureDeviceId 的值。

如果控制器端口设备没有物理连接，该函数将返回 ERROR_DEVICE_NOT_CONNECTED。

如果函数失败，它将返回一个 Win32 错误代码。

备注

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

有关详细信息，请参阅 XInputOnGameInput 包装器。

要求

头文件：XInputOnGameInput.h

库：xgameruntime.lib

支持的平台：Xbox One 系列主机和 Xbox Series 主机

另请参阅

从 XInput 移植到 GameInput
XInputOnGameInput