структура _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 содержит необходимую длину буфера.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Версии:_Supported в Windows Vista и более поздних версиях. |
| заголовка | bthddi.h (include Bthddi.h) |