FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE 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 VmbChannelInitSetMaximumPacketSize-Funktion legt die maximale Paketgröße fest, die über einen Kanal übermittelt werden kann. Dies ist die maximale Größe, die jemals von der VmbPacketSend-Funktion angegeben wird.

Syntax

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE FnVmbChannelInitSetMaximumPacketSize;

NTSTATUS FnVmbChannelInitSetMaximumPacketSize(
  VMBCHANNEL Channel,
  UINT32 PacketSize
)
{...}

Parameter

Channel

Ein Handle für den Kanal.

PacketSize

Maximale Größe eines Pakets in Bytes.

Rückgabewert

VmbChannelInitSetMaximumPacketSize gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER_1	Der Kanalwert war ungültig oder in einem ungültigen Zustand, z. B. Deaktiviert.
STATUS_INVALID_PARAMETER_2	Der PacketSize-Wert ist ungültig. Null (0) ist ungültig.

Hinweise

Diese Funktion kann nur während der Kanalinitialisierung aufgerufen werden.

Die Größe der Ringpuffer basiert teilweise auf dieser maximalen Paketgröße.

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

VmbPacketSend