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
通道值无效或处于无效状态,例如“已禁用”。

备注

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

重要

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

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

要求

   
最低受支持的客户端 Windows 10 版本 1803
Header vmbuskernelmodeclientlibapi.h