IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)

Статья
08/07/2023

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL Получает описательные сведения о сопряженном устройстве handsfree (HFP).

Этот IOCTL доступен в Windows 8.1 и более поздних операционных системах и заменяет IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

None

Длина входного буфера

None

Выходной буфер

Буфер, содержащий BTHHFP_DESCRIPTOR2 структуру, за которой следуют любые другие данные, на которые ссылается эта структура. Это верно, если размер выходного буфера является достаточным и запрос завершается успешно. В частности, буфер содержит хранилище для строки, на которую ссылается поле FriendlyName структуры BTHHFP_DESCRIPTOR2 .

Длина выходного буфера

Размер BTHHFP_DESCRIPTOR2 структуры и ссылочных данных.

Блок состояния

Если подпрограмма завершается успешно, то параметр Status имеет значение STATUS_SUCCESS а элемент Information — это количество байтов, записываемых подпрограммой в выходной буфер. Обратите внимание, что это может быть больше размера структуры BTHHFP_DESCRIPTOR2 , так как выходной буфер может содержать другие данные, на которые ссылается структура BTHHFP_DESCRIPTOR2 .

Если для параметра Состояние задано значение STATUS_BUFFER_TOO_SMALL, то Information — это размер буфера, который вызывающий объект должен выделить для этого запроса.

Звуковой драйвер отправляет этот запрос для получения сведений о включенном интерфейсе устройства GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS. Сведения не изменяются, когда интерфейс включен, но могут изменяться, когда интерфейс отключен. Поэтому звуковой драйвер отправляет этот запрос вскоре после обнаружения включенного интерфейса устройства и использует эти сведения для создания соответствующей структуры KSFILTER_DESCRIPTOR.

Аудиодрайвер отправляет этот запрос один раз с размером выходного буфера, равным нулю (0), чтобы определить требуемый размер выходного буфера. В этом случае запрос завершится с STATUS_BUFFER_TOO_SMALL состояния, а параметр Information будет содержать требуемый размер буфера. Затем звуковой драйвер выделяет необходимое хранилище и отправляет запрос снова. Как правило, звуковой драйвер сохраняет указатель на это место хранения в контексте устройства для справки во время последующих действий.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1
Минимальная версия сервера	Windows Server 2012 R2
Верхняя часть	bthhfpddi.h