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 de 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.

Comentarios

El marco MBBCx llama al controlador cliente para emitir un mensaje de comando MBIM y, posteriormente, llama de nuevo al controlador cliente 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 respuesta y comando.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1809
Plataforma de destino	Universal
Versión mínima de KMDF	1.27
Encabezado	mbbcx.h
Library	mbbcxstub.lib
IRQL	PASSIVE_LEVEL