MbbRequestGetCorrelationId, fonction (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 vers l’objet framework qui représente une requête 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 de retour

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. Le pilote client n’est donc pas requis pour analyser le message MBIM si une certaine sorte de corrélation est nécessaire.

Remarques

L’infrastructure MBBCx appelle le pilote client pour émettre un message de commande MBIM, puis les appels ultérieurs au pilote client pour récupérer le message de réponse de 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 commandes et de messages de réponse est demandée.

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1809
plateforme cible	Universel
version minimale de KMDF	1.27
d’en-tête	mbbcx.h
bibliothèque	mbbcxstub.lib
IRQL	PASSIVE_LEVEL