Função MbbRequestGetCorrelationId (mbbcx.h)

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