FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME回调函数 (vmbuskernelmodeclientlibapi.h)

[一些信息与预发布产品相关,在商业发行之前可能发生实质性修改。 Microsoft 对于此处提供的信息不作任何明示或默示的担保。]

VmbChannelInitSetFriendlyName 函数 (KMCL) 通道设置内核模式客户端库的友好名称。 友好名称用于调试和性能计数器实例命名。

语法

FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME FnVmbChannelInitSetFriendlyName;

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

参数

Channel

要命名的通道的句柄。

Name

通道的新友好名称。

返回值

如果操作成功,则返回STATUS_SUCCESS,否则返回相应的 NTSTATUS 错误代码。

注解

通道名称应具有描述性,但相对较短且易于理解,例如,网络、SCSI、IDE 或 SynthVideo。

重要

此函数通过 VMBus 内核模式客户端库 (KMCL) 接口调用,由 Vmbkmcl.sys 总线驱动程序提供。 这是从 KMCL_CLIENT_INTERFACE_V1 结构访问的客户端函数。

有关详细信息,请参阅 KMCL_CLIENT_INTERFACE_V1的“备注”部分。

要求

要求
最低受支持的客户端 Windows 10 版本 1803
标头 vmbuskernelmodeclientlibapi.h