Поделиться через


Функция 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 Audio для отрисовки (динамики).

[in, out, optional] pRenderCount

Размер (в расширенных символах) буфера строки идентификатора устройства отрисовки.

[out, optional] pCaptureDeviceId

Строка идентификатора устройства Windows Core Audio для записи (микрофона).

[in, out, optional] pCaptureCount

Размер буфера строки идентификатора устройства захвата (в расширенных символах).

Возвращаемое значение

Если функция успешно получает идентификаторы устройств для отрисовки и записи, код возврата ERROR_SUCCESS.

Если к контроллеру не подключена гарнитура, функция также получает ERROR_SUCCESS со значением NULL в качестве значений pRenderDeviceId и pCaptureDeviceId.

Если устройство порта контроллера не подключено физически, функция вернет ERROR_DEVICE_NOT_CONNECTED.

Если функция завершается сбоем, она возвращает допустимый код ошибки Win32.

Комментарии

Вызывающие стороны должны выделять память для буферов, передаваемых в XInputGetAudioDeviceIds. Результирующая строка может иметь произвольную длину.

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

Windows 8 (XInput 1.4)

Требования

   
Целевая платформа Windows
Header xinput.h
Библиотека Xinput.lib
DLL Xinput1_4.dll

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

Api-интерфейсы core audio

Функции XInput

XInputGetDSoundAudioDeviceGuids