Функция MbbRequestGetCorrelationId (mbbcx.h)

Клиентские драйверы могут вызывать метод MbbRequestGetCorrelationId , чтобы сопоставить пару запросов на отправку и получение, которые обмениваются управляющими сообщениями MBIM между платформой MBBCx и драйвером клиента.

Синтаксис

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Параметры

Request

Дескриптор объекта платформы, который представляет запрос от платформы MBBCx, либо для отправки сообщения команды элемента управления MBIM на устройство, либо для получения ответного сообщения элемента управления MBIM от устройства.

Возвращаемое значение

Возвращает значение GUID.

Назначение GUID аналогично полю TransactionId заголовка сообщения MBIM, определенного в спецификации MBIM. Платформа MBBCx предоставляет это значение, поэтому драйвер клиента не требуется анализировать сообщение MBIM, если требуется какая-то корреляция.

Комментарии

Платформа MBBCx вызывает драйвер клиента для выдачи сообщения команды MBIM, а затем снова вызывает драйвер клиента для получения ответного сообщения для этой команды. Значение GUID, возвращаемое для обоих вызовов, будет одинаковым и изменится только при запросе новой пары команд и ответных сообщений.

В некоторых случаях пара команд и ответных сообщений может быть ограничена из-за ограничений размера. В этом случае все фрагменты из одной пары будут иметь одинаковое значение GUID.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1809
Целевая платформа	Универсальное
Минимальная версия KMDF	1.27
Верхняя часть	mbbcx.h
Библиотека	mbbcxstub.lib
IRQL	PASSIVE_LEVEL