MbbRequestGetCorrelationId 函数 (mbbcx.h)

客户端驱动程序可以调用 MbbRequestGetCorrelationId 方法,以关联一对发送和接收请求,这些请求在 MBBCx 框架和客户端驱动程序之间交换 MBIM 控制消息。

语法

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

参数

Request

表示来自 MBBCx 框架的请求的框架对象的句柄,用于向设备发送 MBIM 控制命令消息或接收来自设备的 MBIM 控件响应消息。

返回值

返回一个 GUID 值。

GUID 的用途类似于 MBIM 规范中定义的 MBIM 消息头的 TransactionId 字段。 MBBCx 框架提供此值,因此,如果需要某种关联,则不需要客户端驱动程序来分析 MBIM 消息。

注解

MBBCx 框架调用客户端驱动程序以发出 MBIM 命令消息,稍后再次调用客户端驱动程序以检索该命令的响应消息。 为两个调用返回的 GUID 值将相同,并且仅当请求新的命令和响应消息对时才会更改。

有时,由于大小限制,命令和响应消息对可能会碎片化。 在这种情况下,同一对中的所有片段将具有相同的 GUID 值。

要求

要求
最低受支持的客户端 Windows 10 版本 1809
目标平台 通用
最低 KMDF 版本 1.27
标头 mbbcx.h
Library mbbcxstub.lib
IRQL PASSIVE_LEVEL