XInputGetDSoundAudioDeviceGuids 関数 (xinput.h)

指定したコントローラーに接続されているヘッドセットに関連付けられているサウンドレンダリングおよびサウンドキャプチャデバイス GUID を取得します。

構文

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

dwUserIndex

[入力]ユーザーのコントローラーのインデックス。 0 ~ 3 の範囲の値を指定できます。この値の決定方法と、値がコントローラー上のインジケーターにどのようにマップされるかについては、「複数のコントローラー」を参照してください。

pDSoundRenderGuid

[out]ヘッドセットサウンドレンダリングデバイスの GUID を受け取るポインター。

pDSoundCaptureGuid

[out]ヘッドセットサウンドキャプチャデバイスの GUID を受け取るポインター。

関数がレンダリングおよびキャプチャ用のデバイス ID を正常に取得した場合、戻りコードは ERROR_SUCCESS。

コントローラーに接続されているヘッドセットがない場合、関数は pDSoundRenderGuid と pDSoundCaptureGuid の値として GUID_NULL を持つERROR_SUCCESSも取得します。

コントローラーポートデバイスが物理的に接続されていない場合、関数は 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)