FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]
Die VmbConvertVmbusHandleToKernelHandle-Funktion konvertiert das VMBus-Handle des Benutzermodus in den Kernelmodushandle.
Syntax
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;
NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
HANDLE VmbusHandle,
PHANDLE KernelHandle
)
{...}
Parameter
VmbusHandle
Das Zu konvertierende Benutzermodushandle. Dies muss im Arbeitsprozess des virtuellen Computers geöffnet worden sein.
KernelHandle
Das Kernelhandle, das auf dasselbe Objekt verweist wie der VmbusHandle Wert.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder einen entsprechenden NTSTATUS-Fehlercode andernfalls.
Bemerkungen
Der Aufrufer ist für das Schließen des Kernelhandle verantwortlich.
Da der VmbusHandle Parameter ein Benutzermodushandle ist, muss diese Funktion im Kontext des Benutzermodusprozesses aufgerufen werden, der das VMBus-Handle geöffnet hat.
Das Aufrufen dieser Funktion folgt häufig unmittelbar dem Aufrufen der VmbServerChannelInitSetVmbusHandle-Funktion.
Wichtig
Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine servergeschützte Funktion, 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 |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1803 |
| Header- | vmbuskernelmodeclientlibapi.h |