Fonction MbbRequestGetCorrelationId (mbbcx.h)

Les pilotes clients peuvent appeler la méthode MbbRequestGetCorrelationId pour mettre en corrélation une paire de demandes d’envoi et de réception qui échangent des messages de contrôle MBIM entre l’infrastructure MBBCx et le pilote client.

Syntaxe

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Paramètres

Request

Handle de l’objet framework qui représente une demande de l’infrastructure MBBCx, soit pour envoyer un message de commande de contrôle MBIM à l’appareil, soit pour recevoir un message de réponse de contrôle MBIM de l’appareil.

Valeur retournée

Retourne une valeur GUID.

L’objectif du GUID est similaire au champ TransactionId de l’en-tête de message MBIM défini dans la spécification MBIM. L’infrastructure MBBCx fournit cette valeur, de sorte que le pilote client n’est pas obligé d’analyser le message MBIM si une sorte de corrélation est nécessaire.

Remarques

L’infrastructure MBBCx appelle le pilote client pour émettre un message de commande MBIM, puis appelle à nouveau le pilote client pour récupérer le message de réponse pour cette commande. La valeur GUID retournée pour les deux appels sera la même, et elle ne changerait que si une nouvelle paire de messages de commande et de réponse est demandée.

Parfois, la paire de messages de commande et de réponse peut être fragmentée en raison de limitations de taille. Dans ce cas, tous les fragments de la même paire auront la même valeur GUID.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809
Plateforme cible	Universal
Version KMDF minimale	1,27 %
En-tête	mbbcx.h
Bibliothèque	mbbcxstub.lib
IRQL	PASSIVE_LEVEL