Função MbbRequestGetCorrelationId (mbbcx.h)

Os drivers cliente podem chamar o método MbbRequestGetCorrelationId para correlacionar um par de solicitações de envio e recebimento que trocam mensagens de controle MBIM entre a estrutura MBBCx e o driver do cliente.

Sintaxe

LPCGUID MbbRequestGetCorrelationId(
  MBBREQUEST Request
);

Parâmetros

Request

Um identificador para o objeto de estrutura que representa uma solicitação da estrutura MBBCx, seja para enviar uma mensagem de comando de controle MBIM para o dispositivo ou para receber uma mensagem de resposta de controle MBIM do dispositivo.

Retornar valor

Retorna um valor guid.

A finalidade do GUID é semelhante ao campo TransactionId do cabeçalho da mensagem MBIM definido na especificação do MBIM. A estrutura MBBCx fornece esse valor, portanto, o driver cliente não é necessário para analisar a mensagem MBIM se algum tipo de correlação for necessário.

Comentários

A estrutura MBBCx chama o driver cliente para emitir uma mensagem de comando do MBIM e, posteriormente, chama o driver cliente novamente para recuperar a mensagem de resposta para esse comando. O valor guid retornado para ambas as chamadas será o mesmo e só será alterado se um novo par de mensagens de comando e resposta for solicitado.

Às vezes, o par de mensagens de comando e resposta pode ficar fragemented devido a limitações de tamanho. Nesse caso, todos os fragmentos do mesmo par terão o mesmo valor de GUID.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1809
Plataforma de Destino	Universal
Versão mínima do KMDF	1.27
Cabeçalho	mbbcx.h
Biblioteca	mbbcxstub.lib
IRQL	PASSIVE_LEVEL