IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL 获取有关 HFP) 设备 (配对的免提配置文件的描述性信息。

此 IOCTL 在 Windows 8.1 及更高版本的操作系统中可用,并取代IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

输入缓冲区长度

输出缓冲区

包含 BTHHFP_DESCRIPTOR2 结构的缓冲区,后跟该结构引用的任何其他数据。 如果输出缓冲区大小足够且请求成功,则为 true。 具体而言,缓冲区包括由 BTHHFP_DESCRIPTOR2 结构的 FriendlyName 字段引用的字符串的存储。

输出缓冲区长度

BTHHFP_DESCRIPTOR2结构和引用数据的大小。

状态块

如果例程成功,则 Status 设置为 STATUS_SUCCESS并且 信息 成员是例程写入输出缓冲区的字节数。 请注意,这可能大于 BTHHFP_DESCRIPTOR2 结构的大小,因为输出缓冲区可能包含 BTHHFP_DESCRIPTOR2 结构引用的其他数据。

如果“状态”设置为“STATUS_BUFFER_TOO_SMALL”,则 “信息” 是调用方应为此请求分配的缓冲区大小。

注解

音频驱动程序发送此请求以获取有关已启用GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS设备接口的信息。 启用接口时信息不会更改,但在禁用接口时可能会更改。 因此,音频驱动程序会在发现已启用的设备接口后不久发送此请求,并使用这些信息生成适当的KSFILTER_DESCRIPTOR结构。

音频驱动程序发送一次输出缓冲区大小为 0 (0) 的请求,以确定所需的输出缓冲区大小。 在这种情况下,请求将以 Status STATUS_BUFFER_TOO_SMALL完成, 并且 Information 参数将包含所需的缓冲区大小。 然后,音频驱动程序分配必要的存储并再次发送请求。 通常,音频驱动程序会在其设备上下文中保留指向此存储位置的指针,以便在后续活动中参考。

要求

要求
最低受支持的客户端 Windows 8.1
最低受支持的服务器 Windows Server 2012 R2
标头 bthhfpddi.h

另请参阅

BTHHFP_DESCRIPTOR2

蓝牙 HFP DDI IOCTL

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR