XInputGetDSoundAudioDeviceGuids 函数 (xinput.h)

获取与连接到指定控制器的头戴显示设备关联的声音呈现和声音捕获设备 GUID。

语法

DWORD XInputGetDSoundAudioDeviceGuids(
  DWORD dwUserIndex,
  GUID  *pDSoundRenderGuid,
  GUID  *pDSoundCaptureGuid
);

dwUserIndex

[in]用户控制器的索引。它可以是 0-3 范围内的值。有关如何确定此值以及如何将值映射到控制器上的指示器的信息，请参阅多个控制器。

pDSoundRenderGuid

[out]接收头戴显示设备声音呈现设备的 GUID 的指针。

pDSoundCaptureGuid

[out]接收头戴显示设备声音捕获设备的 GUID 的指针。

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

如果没有头戴显示设备连接到控制器，函数还会检索 ERROR_SUCCESSGUID_NULL作为pDSoundRenderGuid 和 pDSoundCaptureGuid 的值。

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

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

不建议使用旧版 DirectSound，DirectSound 不适用于 Windows 应用商店应用。

注意XInputGetDSoundAudioDeviceGuids 已弃用，因为 Windows 8 (XInput 1.4) 不支持它。

DirectX SDK (XInput 1.3) 、Windows Vista (XInput 9.1.0)