Función MbbRequestGetCorrelationId (mbbcx.h)

Los controladores de cliente pueden llamar al método MbbRequestGetCorrelationId para correlacionar un par de solicitudes de envío y recepción que intercambian mensajes de control MBIM entre el marco MBBCx y el controlador cliente.

Sintaxis

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Parámetros

Request

Identificador del objeto de marco que representa una solicitud del marco MBBCx, ya sea para enviar un mensaje de comando de control MBIM al dispositivo o para recibir un mensaje de respuesta de control MBIM del dispositivo.

Valor devuelto

Devuelve un valor GUID.

El propósito del GUID es similar al campo TransactionId del encabezado de mensaje MBIM definido en la especificación MBIM. El marco MBBCx proporciona este valor, por lo que el controlador de cliente no es necesario analizar el mensaje MBIM si se necesita algún tipo de correlación.

Observaciones

El marco MBBCx llama al controlador cliente para emitir un mensaje de comando MBIM y, posteriormente, llama al controlador cliente de nuevo para recuperar el mensaje de respuesta de ese comando. El valor GUID devuelto para ambas llamadas será el mismo y solo cambiaría si se solicita un nuevo par de mensajes de comando y respuesta.

A veces, el par de mensajes de comando y respuesta podría fragmentarse debido a limitaciones de tamaño. En ese caso, todos los fragmentos del mismo par tendrán el mismo valor GUID.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1809
de la plataforma de destino de	Universal
versión mínima de KMDF	1.27
encabezado de	mbbcx.h
biblioteca de	mbbcxstub.lib
irQL	PASSIVE_LEVEL