FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE funzione di callback (vmbuskernelmodeclientlibapi.h)
[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.
La funzione VmbConvertVmbusHandleToKernelHandle converte l'handle VMBus in modalità kernel.
Sintassi
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;
NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
HANDLE VmbusHandle,
PHANDLE KernelHandle
)
{...}
Parametri
VmbusHandle
Handle in modalità utente da convertire. Questa operazione deve essere stata aperta nel processo di lavoro della macchina virtuale.
KernelHandle
Handle del kernel che fa riferimento allo stesso oggetto del valore VmbusHandle .
Valore restituito
Restituisce STATUS_SUCCESS se l'operazione ha esito positivo o un codice di errore NTSTATUS appropriato in caso contrario.
Commenti
Il chiamante è responsabile della chiusura dell'handle del kernel.
Poiché il parametro VmbusHandle è un handle in modalità utente, questa funzione deve essere chiamata nel contesto del processo in modalità utente che ha aperto l'handle VMBus.
La chiamata a questa funzione viene spesso seguita immediatamente chiamando la funzione VmbServerChannelInitSetVmbusHandle .
Importante
Questa funzione viene chiamata tramite l'interfaccia VMBus Kernel Mode Client Library (KMCL), fornita dal driver del bus di Vmbkmcl.sys. Si tratta di una funzione di sola server a cui si accede dalla struttura KMCL_SERVER_ONLY_METHODS .
Per altre informazioni, vedere la sezione Osservazioni di KMCL_SERVER_ONLY_METHODS.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 1803 |
| Intestazione | vmbuskernelmodeclientlibapi.h |