FN_VMB_CHANNEL_ALLOCATE 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 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 der neue Kanal ein Serverendpunkt ist.

Channel

Ein Zeiger auf einen zugewiesenen Kanal.

Rückgabewert

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

Bemerkungen

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
mindestens unterstützte Client- Windows 10, Version 1803
Header- vmbuskernelmodeclientlibapi.h
IRQL- PASSIVE_LEVEL

Siehe auch

VmbChannelCleanup

VmbChannelEnable-