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