IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

Статья
02/22/2024

Звуковой драйвер выдает код элемента управления IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR для получения сведений о включенном интерфейсе устройства GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS.

Примечание Этот IOCTL заменяет IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES и IOCTL_BTHHFP_DEVICE_GET_CONTAINERID , которые теперь устарели.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Нет.

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

Нет.

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

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

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

Размер BTHHFP_DESCRIPTOR структуры и данных, на которые ссылается ссылка.

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

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

Примечание Это может быть больше размера структуры BTHHFP_DESCRIPTOR , так как выходной буфер может содержать другие данные, на которые ссылается структура.

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

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

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

Требования

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