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

  • Artigo

[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]

A função VmbClientChannelInitSetTargetPnp define o destino de um canal cliente por tipo de interface e IDs de instância. 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) 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. Essa é 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.

Retornar valor

VmbClientChannelInitSetTargetPnp retorna os seguintes valores:

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

Comentários

Se você tiver duas interfaces de rede paravirtual, elas terão os mesmos valores InterfaceType , mas 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 de cliente acessada da estrutura KMCL_CLIENT_INTERFACE_V1 .

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho vmbuskernelmodeclientlibapi.h