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 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.

Valor de retorno

Retorna um valor GUID.

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

Observações

A estrutura MBBCx chama o driver cliente para emitir uma mensagem de comando 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 ser fragmentado devido a limitações de tamanho. Nesse caso, todos os fragmentos do mesmo par terão o mesmo valor GUID.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1809
da Plataforma de Destino	Universal
versão mínima do KMDF	1.27
cabeçalho	mbbcx.h
biblioteca	mbbcxstub.lib
IRQL	PASSIVE_LEVEL