IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)
IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL Получает описательные сведения о сопряженном устройстве handsfree (HFP).
Этот IOCTL доступен в Windows 8.1 и более поздних операционных системах и заменяет IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.
Основной код
Входной буфер
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 |