FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP回调函数 (vmbuskernelmodeclientlibapi.h)

  • 项目

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

VmbClientChannelInitSetTargetPnp 函数按接口类型和实例 ID 设置客户端通道的目标。 如果调用此函数，则内核模式客户端库 (KMCL) 使用 PnP 查找与提供的接口相对应的 VMBus 物理设备对象 (PDO) 。

语法

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

参数

Channel

指向通道的指针。

InterfaceType

指向接口类型 GUID 的指针。 此 GUID 标识通道的类型以及用于通道的协议。

InterfaceInstance

指向实例类型 GUID 的指针。 这是服务的特定实例。 如果未提供，则接受具有所提供类型的任何实例。

PnpFailureCallback

指向事件回调的指针，当设备异步连接失败时调用，即使找到 PnP 设备也是如此。

返回值

VmbClientChannelInitSetTargetPnp 返回以下值：

返回代码 说明
STATUS_INVALID_PARAMETER_1
 通道值无效或处于无效状态，例如 Disabled。

注解

如果有两个半虚拟网络接口，它们将具有相同的 InterfaceType 但不同的 InterfaceInstance 值。

重要

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

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

要求

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