XInputGetAudioDeviceIds 函式 (xinput.h)

  • 發行項

擷取與連接到指定控制器之頭戴裝置相關聯的音效轉譯和音效擷取音訊裝置識別碼。

語法

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 音訊裝置識別碼字串) 。

[in, out, optional] pRenderCount

轉譯裝置識別碼字串緩衝區的大小，以寬字元為單位。

[out, optional] pCaptureDeviceId

用於擷取 (麥克風的 Windows Core 音訊裝置識別碼字串) 。

[in, out, optional] pCaptureCount

擷取裝置識別碼字串緩衝區的大小，以寬字元為單位。

傳回值

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

如果沒有連線到控制器的頭戴式裝置，函式也會擷取 ERROR_SUCCESSNull 作為pRenderDeviceId 和 pCaptureDeviceId的值。

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

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

備註

呼叫端必須為傳遞至 XInputGetAudioDeviceIds的緩衝區配置記憶體。 產生的字串可以是任意長度。

平臺需求

Windows 8 (XInput 1.4)

規格需求

   
目標平台 Windows
標頭 xinput.h
程式庫 Xinput.lib
Dll Xinput1_4.dll

另請參閱

核心音訊 API

XInput 函式

XInputGetDSoundAudioDeviceGuids