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

[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 VmbChannelInitSetFriendlyName define o nome amigável do canal KMCL (Biblioteca de Clientes do Modo Kernel). O nome amigável é usado para depuração e nomenclatura de instância do contador de desempenho.

Sintaxe

FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME FnVmbChannelInitSetFriendlyName;

NTSTATUS FnVmbChannelInitSetFriendlyName(
  VMBCHANNEL Channel,
  PCUNICODE_STRING Name
)
{...}

Parâmetros

Channel

Um identificador para o canal a ser name.

Name

O novo nome amigável do canal.

Retornar valor

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

Comentários

Os nomes de canal devem ser descritivos, mas relativamente curtos e fáceis de entender, por exemplo, Rede, SCSI, IDE ou SynthVideo.

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
Cliente mínimo com suporte	Windows 10, versão 1803
Cabeçalho	vmbuskernelmodeclientlibapi.h