Fungsi XInputGetDSoundAudioDeviceGuids (xinput.h)

Mendapatkan GUID perangkat sound rendering dan sound capture yang terkait dengan headset yang terhubung ke pengontrol yang ditentukan.

Sintaks

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

Parameter

dwUserIndex

[in] Indeks pengontrol pengguna. Ini bisa menjadi nilai dalam rentang 0–3. Untuk informasi tentang bagaimana nilai ini ditentukan dan bagaimana nilai dipetakan ke indikator pada pengontrol, lihat Beberapa Pengontrol.

pDSoundRenderGuid

[out] Pointer yang menerima GUID perangkat penyajian suara headset.

pDSoundCaptureGuid

[out] Pointer yang menerima GUID perangkat pengambilan suara headset.

Mengembalikan nilai

Jika fungsi berhasil mengambil ID perangkat untuk dirender dan diambil, kode pengembalian ERROR_SUCCESS.

Jika tidak ada headset yang terhubung ke pengontrol, fungsi ini juga mengambil ERROR_SUCCESS dengan GUID_NULL sebagai nilai untuk pDSoundRenderGuid dan pDSoundCaptureGuid.

Jika perangkat port pengontrol tidak terhubung secara fisik, fungsi akan mengembalikan ERROR_DEVICE_NOT_CONNECTED.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan Win32 yang valid.

Keterangan

Penggunaan DirectSound warisan tidak disarankan, dan DirectSound tidak tersedia untuk aplikasi Windows Store.

CatatanXInputGetDSoundAudioDeviceGuids tidak digunakan lagi karena tidak didukung oleh Windows 8 (XInput 1.4).

 

Persyaratan Platform

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

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	xinput.h
Pustaka	Xinput.lib; Xinput9_1_0.lib
DLL	Xinput9_1_0.dll

Lihat juga

Fungsi XInput

XInputGetState