структура _BRB_GET_DEVICE_INTERFACE_STRING (bthddi.h)

  • Статья

Структура _BRB_GET_DEVICE_INTERFACE_STRING описывает строку интерфейса устройства для текущего объекта устройства.

Синтаксис

struct _BRB_GET_DEVICE_INTERFACE_STRING {
  BRB_HEADER Hdr;
  PWCHAR     DeviceInterfaceString;
  ULONG      DeviceInterfaceStringCbLength;
};

Члены

Hdr

Структура BRB_HEADER , содержащая сведения о текущем BRB.

DeviceInterfaceString

Указатель на буфер, содержащий строку интерфейса устройства.

DeviceInterfaceStringCbLength

Во входных данных этот элемент указывает длину строки интерфейса устройства в байтах. В выходных данных этот элемент указывает количество байтов, необходимых для строки, если BRB_GET_DEVICE_INTERFACE_STRING BRB завершается сбоем и возвращает STATUS_MORE_ENTRIES из-за недостаточной длины буфера. Если вызов BRB завершается успешно, этот элемент содержит количество скопированных байтов.

Комментарии

Чтобы получить строку интерфейса устройства для текущего объекта устройства, драйверы профиля должны создать и отправить запрос BRB_GET_DEVICE_INTERFACE_STRING .

Стек драйверов Bluetooth выполняет вызов IoRegisterDeviceInterface для каждого создаваемого объекта устройства. BRB возвращает строку интерфейса устройства, возвращенную этим вызовом. Это может быть полезно для регистрации событий.

Если буфер, на который указывает элемент DeviceInterfaceString , недостаточно велик для хранения строки, вызов завершается ошибкой и элемент DeviceInterfaceStringCbLength содержит необходимую длину буфера.

Требования

Требование Значение
Минимальная версия клиента Versions:_Supported в Windows Vista и более поздних версиях.
Верхняя часть bthddi.h (включая Bthddi.h)

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

BRB_GET_DEVICE_INTERFACE_STRING

BRB_HEADER

IoRegisterDeviceInterface