nc-vmbuskernelmodeclientlibapi-fn_vmb_channel_set_pointer.md

UID	title	description	tech.root	ms.date	keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.lib	req.dll	req.irql	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	targetos	ms.custom	f1_keywords	topic_type	api_type	api_location	api_name
NC:vmbuskernelmodeclientlibapi.FN_VMB_CHANNEL_SET_POINTER	FN_VMB_CHANNEL_SET_POINTER (vmbuskernelmodeclientlibapi.h)	The VmbChannelSetPointer function saves an arbitrary pointer in a channel context.	netvista	05/22/2018	FN_VMB_CHANNEL_SET_POINTER callback function	vmbuskernelmodeclientlibapi.h			Windows 10, version 1803														Windows	RS5	FN_VMB_CHANNEL_SET_POINTER vmbuskernelmodeclientlibapi/FN_VMB_CHANNEL_SET_POINTER	apiref	UserDefined	vmbuskernelmodeclientlibapi.h	FN_VMB_CHANNEL_SET_POINTER

FN_VMB_CHANNEL_SET_POINTER callback function

-description

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

The VmbChannelSetPointer function saves an arbitrary pointer in a channel context.

-parameters

-param Channel

A handle for a channel.

-param Pointer

Arbitrary pointer to save in the channel's context.

-prototype

//Declaration

FN_VMB_CHANNEL_SET_POINTER FnVmbChannelSetPointer; 

// Definition

VOID FnVmbChannelSetPointer 
(
	VMBCHANNEL Channel
	__drv_aliasesMem PVOID Pointer
)
{...}

-remarks

This is intended to be a more efficient way for a client driver to retrieve client driver's context. For more information, see the VmbChannelGetPointer function.

Important

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

For more information, see the Remarks section of the KMCL_CLIENT_INTERFACE_V1.

-see-also

VmbChannelGetPointer