FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME 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 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 da 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 nome do canal.

Name

O novo nome amigável do canal.

Valor de retorno

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

Observações

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

Compartilhar via