MbbRequestGetCorrelationId-Funktion (mbbcx.h)

Clienttreiber können die MbbRequestGetCorrelationId-Methode aufrufen, um ein Paar von Sende- und Empfangsanforderungen zu korrelieren, die MBIM-Steuerelementnachrichten zwischen dem MBBCx-Framework und dem Clienttreiber austauschen.

Syntax

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Parameter

Request

Ein Handle für das Frameworkobjekt, das eine Anforderung des MBBCx-Frameworks darstellt, um entweder eine MBIM-Steuerelementbefehlsnachricht an das Gerät zu senden oder eine MBIM-Steuerelementantwortmeldung vom Gerät zu empfangen.

Rückgabewert

Gibt einen GUID-Wert zurück.

Der Zweck der GUID ähnelt dem Feld TransactionId des MBIM-Nachrichtenheaders, der in der MBIM-Spezifikation definiert ist. Das MBBCx-Framework stellt diesen Wert bereit, sodass der Clienttreiber nicht erforderlich ist, um die MBIM-Nachricht zu analysieren, wenn eine Art Von Korrelation erforderlich ist.

Hinweise

Das MBBCx-Framework ruft den Clienttreiber auf, um eine MBIM-Befehlsnachricht auszugeben, und ruft später erneut den Clienttreiber auf, um die Antwortnachricht für diesen Befehl abzurufen. Der für beide Aufrufe zurückgegebene GUID-Wert ist identisch, und er würde sich nur ändern, wenn ein neues Befehls- und Antwortmeldungspaar angefordert wird.

Manchmal kann das Befehls- und Antwortmeldungspaar aufgrund von Größenbeschränkungen fragmentiert werden. In diesem Fall verfügen alle Fragmente aus demselben Paar über den gleichen GUID-Wert.

Anforderungen