FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID callback function (vmbuskernelmodeclientlibapi.h)

The VmbServerChannelInitSetTargetInterfaceId function sets the target interface type GUID and instance GUID of the channel offer.

Syntax

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID FnVmbServerChannelInitSetTargetInterfaceId;

NTSTATUS FnVmbServerChannelInitSetTargetInterfaceId(
  VMBCHANNEL Channel,
  GUID InterfaceType,
  GUID InterfaceInstance
)
{...}

Parameters

Channel

A handle for a channel.

InterfaceType

A pointer to the interface type GUID.

InterfaceInstance

A pointer to the instance type GUID.

Return value

Returns STATUS_SUCCESS if the operation is successful. Otherwise, returns an appropriate NTSTATUS error code.

Remarks

The InterfaceType GUID identifies the type of channel and, specifically, the protocol that is used with the channel. If the VMBus in the child partition is creating a Physical Device Object (PDO) that is associated with this channel, this GUID is the basis of the PDO's hardware ID reported to the PnP Manager.

The InterfaceInstance GUID identifies a specific instance of the service. For instance, If you have two paravirtual network interfaces, they have the same interface type, but different interface instance values.

Important

This function is called through the VMBus Kernel Mode Client Library (KMCL) interface, provided by the Vmbkmcl.sys bus driver. This is a server-only function accessed from the KMCL_SERVER_ONLY_METHODS structure.

For more information, see the Remarks section of KMCL_SERVER_ONLY_METHODS.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1809
Header	vmbuskernelmodeclientlibapi.h