Freigeben über

FN_VMB_PACKET_INITIALIZE Rückruffunktion (vmbuskernelmodeclientlibapi.h)

  • Artikel

[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 VmbPacketInitialize-Funktion initialisiert einen Puffer, der ein VMBus-Paket enthält.

Syntax

FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;

NTSTATUS FnVmbPacketInitialize(
  VMBCHANNEL Channel,
  VMBPACKET VmbPacket,
  UINT32 ByteCount
)
{...}

Parameter

Channel

Ein Handle für einen Kanal.

VmbPacket

Der Puffer, der zum Speichern des VMBus-Pakets verwendet werden soll.

ByteCount

Die Größe des Puffers in Bytes.

Rückgabewert

VmbPacketInitialize gibt die folgenden status-Codes zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Die Funktion wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER_3
 Der Wert von ByteCount ist ungültig. Er muss größer als die maximale Paketgröße plus die Größe eines Voidzeigers sein.

Hinweise

Die Größe des Puffers muss mindestens die Größe sein, die mithilfe der Funktion VmbChannelSizeofPacket berechnet wird.

VmbPacketInitialize ist eine Alternative zur VmbPacketAllocate-Funktion . Verwenden Sie die aktuelle Funktion, wenn der Aufrufer den Arbeitsspeicher für das Paketobjekt bereitstellt.

Die anfängliche Vervollständigungsroutine des Pakets ist ungültig und muss vor dem Senden des Pakets festgelegt 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

Weitere Informationen

VmbChannelSizeofPacket

VmbPacketAllocate