_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 相关信息的 BRB_HEADER 结构。

DeviceInterfaceString

指向包含设备接口字符串的缓冲区的指针。

DeviceInterfaceStringCbLength

在输入时，此成员指定设备接口字符串的长度（以字节为单位）。在输出时，此成员指定字符串所需的字节数（如果 BRB_GET_DEVICE_INTERFACE_STRING BRB 由于缓冲区长度不足而失败并返回STATUS_MORE_ENTRIES。如果 BRB 调用成功，则此成员包含复制的字节数。

若要获取当前设备对象的设备接口字符串，配置文件驱动程序应生成并发送 BRB_GET_DEVICE_INTERFACE_STRING 请求。

蓝牙驱动程序堆栈对其创建的每个设备对象执行 IoRegisterDeviceInterface 调用。 BRB 返回该调用返回的设备接口字符串。这对于注册事件非常有用。

如果 DeviceInterfaceString 成员指向的缓冲区不够大，无法容纳字符串，则调用将失败， 并且 DeviceInterfaceStringCbLength 成员包含所需的缓冲区长度。

要求	值
最低受支持的客户端	版本：Windows Vista 及更高版本中_Supported。
标头	bthddi.h (包括 Bthddi.h)