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

Weitere Informationen

VmbServerChannelInitSetVmbusHandle