MbbRequestGetCorrelationId 関数 (mbbcx.h)

クライアント ドライバーは 、MbbRequestGetCorrelationId メソッドを呼び出して、MBBCx フレームワークとクライアント ドライバーの間で MBIM 制御メッセージを交換する送受信要求のペアを関連付けることができます。

構文

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

パラメーター

Request

MBBCx フレームワークからの要求を表すフレームワーク オブジェクトへのハンドル。MBIM 制御コマンド メッセージをデバイスに送信するか、デバイスから MBIM 制御応答メッセージを受信します。

戻り値

GUID 値を返します。

GUID の目的は、MBIM 仕様で定義されている MBIM メッセージ ヘッダーの TransactionId フィールドに似ています。 MBBCx フレームワークはこの値を提供するため、何らかの相関関係が必要な場合、クライアント ドライバーは MBIM メッセージを解析する必要はありません。

注釈

MBBCx フレームワークは、クライアント ドライバーを呼び出して MBIM コマンド メッセージを発行し、後でクライアント ドライバーを再度呼び出して、そのコマンドの応答メッセージを取得します。 両方の呼び出しで返される GUID 値は同じになり、新しいコマンドと応答メッセージのペアが要求された場合にのみ変更されます。

サイズの制限により、コマンドと応答メッセージのペアが断片化することがあります。 その場合、同じペアのすべてのフラグメントは同じ GUID 値を持ちます。

要件