FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
Die VmbConvertVmbusHandleToKernelHandle-Funktion konvertiert das VMBus-Handle im Benutzermodus in das Handle im Kernelmodus.
Syntax
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;
NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
HANDLE VmbusHandle,
PHANDLE KernelHandle
)
{...}
Parameter
VmbusHandle
Das zu konvertierende Benutzermodushandle. Dieser muss im Workerprozess des virtuellen Computers geöffnet worden sein.
KernelHandle
Das Kernelhandle, das auf dasselbe Objekt wie den VmbusHandle-Wert verweist.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder andernfalls einen entsprechenden NTSTATUS-Fehlercode.
Hinweise
Der Aufrufer ist für das Schließen des Kernelhandles verantwortlich.
Da der VmbusHandle-Parameter ein Benutzermodushandle ist, muss diese Funktion im Kontext des Benutzermodusprozesses aufgerufen werden, der das VMBus-Handle geöffnet hat.
Auf das Aufrufen dieser Funktion folgt häufig unmittelbar der Aufruf der Funktion VmbServerChannelInitSetVmbusHandle .
Wichtig
Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine reine Serverfunktion, auf die über die KMCL_SERVER_ONLY_METHODS-Struktur zugegriffen wird.
Weitere Informationen finden Sie im Abschnitt Hinweise von KMCL_SERVER_ONLY_METHODS.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 |
| Kopfzeile | vmbuskernelmodeclientlibapi.h |