FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE fonction de rappel (vmbuskernelmodeclientlibapi.h)

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

La fonction VmbConvertVmbusHandleToKernelHandle convertit le handle VMBus en mode utilisateur en handle de mode noyau.

Syntaxe

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;

NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
  HANDLE VmbusHandle,
  PHANDLE KernelHandle
)
{...}

Paramètres

VmbusHandle

Handle en mode utilisateur à convertir. Celui-ci doit avoir été ouvert dans le processus de travail de machine virtuelle.

KernelHandle

Handle du noyau qui fait référence au même objet que la valeur VmbusHandle .

Valeur retournée

Retourne STATUS_SUCCESS si l’opération réussit, ou un code d’erreur NTSTATUS approprié dans le cas contraire.

Remarques

L’appelant est responsable de la fermeture du handle du noyau.

Étant donné que le paramètre VmbusHandle est un handle en mode utilisateur, cette fonction doit être appelée dans le contexte du processus en mode utilisateur qui a ouvert le handle VMBus.

L’appel de cette fonction est souvent immédiatement suivi par l’appel de la fonction VmbServerChannelInitSetVmbusHandle .

Important

Cette fonction est appelée via l’interface KMCL (Kernel Mode Client Library) VMBus, fournie par le pilote de bus Vmbkmcl.sys. Il s’agit d’une fonction serveur uniquement accessible à partir de la structure KMCL_SERVER_ONLY_METHODS .

Pour plus d’informations, consultez la section Remarques de KMCL_SERVER_ONLY_METHODS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	vmbuskernelmodeclientlibapi.h

Voir aussi

VmbServerChannelInitSetVmbusHandle