Функция 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 |