Функция 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 не рекомендуется, а DirectSound недоступен для приложений Магазина Windows.

ПримечаниеXInputGetDSoundAudioDeviceGuids не рекомендуется использовать, так как он не поддерживается Windows 8 (XInput 1.4).
 

Требования к платформе

Пакет SDK для DirectX (XInput 1.3), Windows Vista (XInput 9.1.0)

Требования

Требование Значение
Целевая платформа Windows
Header xinput.h
Библиотека Xinput.lib; Xinput9_1_0.lib
DLL Xinput9_1_0.dll

См. также раздел

Функции XInput

XInputGetState