FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP função de retorno de chamada (vmbuskernelmodeclientlibapi.h)

Artigo
02/07/2025

[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não faz garantias, expressas ou implícitas, em relação às informações fornecidas aqui.]

A função VmbClientChannelInitSetTargetPnp define o destino de um canal cliente por IDs de instância e tipo de interface. Se essa função for chamada, a KMCL (Biblioteca de Clientes do Modo Kernel) usará PnP para localizar o PDO (Objeto de Dispositivo Físico) do VMBus que corresponde à interface fornecida.

Sintaxe

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

Parâmetros

Channel

Um ponteiro para um canal.

InterfaceType

Um ponteiro para o GUID do tipo de interface. Esse GUID identifica o tipo de canal e o protocolo usado com o canal.

InterfaceInstance

Um ponteiro para o GUID do tipo de instância. Esta é uma instância específica do serviço. Se não for fornecido, qualquer instância com o tipo fornecido será aceita.

PnpFailureCallback

Um ponteiro para um retorno de chamada de evento para chamar se o dispositivo falhar de forma assíncrona ao se conectar mesmo que o dispositivo PnP esteja localizado.

Valor de retorno

VmbClientChannelInitSetTargetPnp retorna os seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER_1	O valor do Canal era inválido ou em um estado inválido, como Desabilitado.

Observações

Se você tiver dois adaptadores de rede paravirtual, eles terão o mesmo InterfaceType, mas valores interfaceinstance diferentes.

Importante

Essa função é chamada por meio da interface KMCL (Biblioteca de Clientes do Modo Kernel do VMBus), fornecida pelo driver de barramento Vmbkmcl.sys. Essa é uma função cliente acessada da estrutura de KMCL_CLIENT_INTERFACE_V1.

Para obter mais informações, consulte a seção Comentários do KMCL_CLIENT_INTERFACE_V1.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1803
cabeçalho	vmbuskernelmodeclientlibapi.h

Compartilhar via