_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)

另请参阅

BRB_GET_DEVICE_INTERFACE_STRING

BRB_HEADER

IoRegisterDeviceInterface