FN_VMB_CHANNEL_ALLOCATE 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 VmbChannelAllocate-Funktion weist einen neuen VMBus-Kanal zu, der Standardparameter und Rückrufe enthält.

Syntax

FN_VMB_CHANNEL_ALLOCATE FnVmbChannelAllocate;

NTSTATUS FnVmbChannelAllocate(
  PDEVICE_OBJECT ParentDeviceObject,
  BOOLEAN IsServer,
  VMBCHANNEL *Channel
)
{...}

Parameter

ParentDeviceObject

Ein Zeiger auf das übergeordnete Gerät.

IsServer

Gibt an, ob es sich bei dem neuen Kanal um einen Serverendpunkt handelt.

Channel

Ein Zeiger auf einen zugeordneten Kanal.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder andernfalls einen entsprechenden NTSTATUS-Fehlercode.

Hinweise

Der Kanal kann mithilfe der VMBus-Kanalinitialisierungsroutinen weiter initialisiert werden, bevor er mithilfe der Funktion VmbChannelEnable aktiviert wird. Der Kanal muss mithilfe der Funktion VmbChannelCleanup freigegeben werden.

Wichtig

Diese Funktion wird über die KMCL-Schnittstelle (VmBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine Clientfunktion, auf die über die KMCL_CLIENT_INTERFACE_V1-Struktur zugegriffen wird.

Weitere Informationen finden Sie im Abschnitt Hinweise des KMCL_CLIENT_INTERFACE_V1.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	vmbuskernelmodeclientlibapi.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

VmbChannelCleanup

VmbChannelEnable