Fungsi MbbRequestGetCorrelationId (mbbcx.h)

Driver klien dapat memanggil metode MbbRequestGetCorrelationId untuk menghubungkan sepasang permintaan kirim dan terima yang bertukar pesan kontrol MBIM antara kerangka kerja MBBCx dan driver klien.

Sintaks

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Parameter

Request

Handel ke objek kerangka kerja yang mewakili permintaan dari kerangka kerja MBBCx, baik untuk mengirim pesan perintah kontrol MBIM ke perangkat atau untuk menerima pesan respons kontrol MBIM dari perangkat.

Menampilkan nilai

Mengembalikan nilai GUID.

Tujuan GUID mirip dengan bidang TransactionId dari header pesan MBIM yang ditentukan dalam spesifikasi MBIM. Kerangka kerja MBBCx menyediakan nilai ini, sehingga driver klien tidak diperlukan untuk mengurai pesan MBIM jika semacam korelasi diperlukan.

Keterangan

Kerangka kerja MBBCx memanggil ke driver klien untuk mengeluarkan pesan perintah MBIM, dan kemudian memanggil ke driver klien lagi untuk mengambil pesan respons untuk perintah tersebut. Nilai GUID yang dikembalikan untuk kedua panggilan akan sama, dan hanya akan berubah jika pasangan pesan perintah dan respons baru diminta.

Terkadang, pasangan pesan perintah dan respons mungkin terfragmentasi karena keterbatasan ukuran. Dalam hal ini, semua fragmen dari pasangan yang sama akan memiliki nilai GUID yang sama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, version 1809
Target Platform	Universal
Versi KMDF minimum	1.27
Header	mbbcx.h
Pustaka	mbbcxstub.lib
IRQL	PASSIVE_LEVEL