Funzione MbbRequestGetCorrelationId (mbbcx.h)

I driver client possono chiamare il metodo MbbRequestGetCorrelationId per correlare una coppia di richieste di invio e ricezione che scambiano messaggi di controllo MBIM tra il framework MBBCx e il driver client.

Sintassi

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Parametri

Request

Handle per l'oggetto framework che rappresenta una richiesta dal framework MBBCx, per inviare un messaggio di comando di controllo MBIM al dispositivo o per ricevere un messaggio di risposta del controllo MBIM dal dispositivo.

Valore restituito

Restituisce un valore GUID.

Lo scopo del GUID è simile al campo TransactionId dell'intestazione del messaggio MBIM definito nella specifica MBIM. Il framework MBBCx fornisce questo valore, quindi il driver client non è necessario per analizzare il messaggio MBIM se è necessaria una certa correlazione.

Commenti

Il framework MBBCx chiama il driver client per emettere un messaggio di comando MBIM e successivamente chiama nuovamente nel driver client per recuperare il messaggio di risposta per tale comando. Il valore GUID restituito per entrambe le chiamate sarà lo stesso e verrà modificato solo se viene richiesta una nuova coppia di comandi e messaggi di risposta.

A volte, la coppia di messaggi di comando e risposta potrebbe essere frammentata a causa delle limitazioni delle dimensioni. In tal caso, tutti i frammenti della stessa coppia avranno lo stesso valore GUID.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809
Piattaforma di destinazione	Universale
Versione KMDF minima	1.27
Intestazione	mbbcx.h
Libreria	mbbcxstub.lib
IRQL	PASSIVE_LEVEL