XInputGetDSoundAudioDeviceGuids 函式 (xinput.h)

取得與連接到指定控制器之頭戴式裝置相關聯的音效轉譯和音效擷取裝置 GUID。

語法

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

dwUserIndex

[in]使用者控制器的索引。它可以是範圍 0–3 中的值。如需如何判斷此值以及如何將值對應至控制器上指標的資訊，請參閱多個控制器。

pDSoundRenderGuid

[out]接收頭戴裝置音效轉譯裝置 GUID 的指標。

pDSoundCaptureGuid

[out]接收頭戴裝置音效擷取裝置 GUID 的指標。

如果函式成功擷取裝置標識碼以進行轉譯和擷取，則會 ERROR_SUCCESS傳回碼。

如果沒有連線到控制器的頭戴式裝置，函式也會擷取 ERROR_SUCCESS GUID_NULL做為 pDSoundRenderGuid 和 pDSoundCaptureGuid 的值。

如果控制器埠裝置未實際連線，函式會傳回 ERROR_DEVICE_NOT_CONNECTED。

如果函式失敗，它會傳回有效的 Win32 錯誤碼。

不建議使用舊版 DirectSound，而且 Windows 市集應用程式無法使用 DirectSound 。

注意XInputGetDSoundAudioDeviceGuids 已被取代，因為它不支援 Windows 8 (XInput 1.4) 。

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