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

A função VmbServerChannelInitSetTargetInterfaceId define o GUID do tipo de interface de destino e o GUID da instância da oferta de canal.

Sintaxe

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID FnVmbServerChannelInitSetTargetInterfaceId;

NTSTATUS FnVmbServerChannelInitSetTargetInterfaceId(
  VMBCHANNEL Channel,
  GUID InterfaceType,
  GUID InterfaceInstance
)
{...}

Parâmetros

Channel

Um identificador para um canal.

InterfaceType

Um ponteiro para o GUID do tipo de interface.

InterfaceInstance

Um ponteiro para o GUID do tipo de instância.

Retornar valor

Retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retornará um código de erro NTSTATUS apropriado.

Comentários

O GUID InterfaceType identifica o tipo de canal e, especificamente, o protocolo usado com o canal. Se o VMBus na partição filho estiver criando um PDO (Objeto de Dispositivo Físico) associado a esse canal, esse GUID será a base da ID de hardware do PDO relatada ao Gerenciador de PnP.

O GUID interfaceInstance identifica uma instância específica do serviço. Por exemplo, se você tiver duas interfaces de rede paravirtual, elas terão o mesmo tipo de interface, mas valores de instância de interface 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 somente de servidor acessada da estrutura KMCL_SERVER_ONLY_METHODS .

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

Requisitos

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