FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL callback function (vmbuskernelmodeclientlibapi.h)

Article
02/22/2024

The VmbServerChannelInitSetTargetVtl function sets the target VTL for this channel. The channel will be offered to clients running in the specified VTL and no others.

Syntax

FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL FnVmbServerChannelInitSetTargetVtl;

NTSTATUS FnVmbServerChannelInitSetTargetVtl(
  VMBCHANNEL Channel,
  UINT8 TargetVtl
)
{...}

Parameters

Channel

A handle for the channel. Allocated by VmbChannelAllocate.

TargetVtl

The VTL level where this channel will be offered.

Return value

VmbServerChannelInitSetTargetVtl returns the following status values:

Return code	Description
STATUS_INVALID_PARAMETER_1	The Channel parameter was invalid or in an invalid state (Disabled).
STATUS_INVALID_PARAMETER_2	TargetVtl is invalid.

Remarks

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

Share via