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 |