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

Статья
02/07/2025

Клиентские драйверы могут вызывать метод 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

Поделиться через