Compartilhar via

Função MbbRequestGetCorrelationId (mbbcx.h)

  • Artigo

Os drivers de 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 framework 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 de mensagem MBIM definido na especificação DO MBIM. A estrutura MBBCx fornece esse valor, portanto, o driver do 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 do 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 ficar fragmentado devido a limitações de tamanho. Nesse caso, todos os fragmentos do mesmo par terão o mesmo valor 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