FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
03/01/2024

[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 VmbChannelInitSetMaximumExternalData-Funktion legt die maximale Größe und Verkettungslänge von Daten fest, die von einem Paket beschrieben, aber nicht direkt im Paket gesendet werden. Das heißt, die maximale Größe des Puffers, der durch eine ExternalDataMdl beschrieben wird.

Syntax

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Parameter

Channel

Ein Zeiger auf einen KMCL-Kanal (Kernel Mode Client Library).

DataSize

Die maximale Größe externer Daten.

ChainLength

Die maximale Anzahl von Arbeitsspeicherdeskriptor-Listen (MDLs) in einer eingehenden MDL-Kette.

Rückgabewert

VmbChannelInitSetMaximumExternalData kann einen der folgenden status-Werte zurückgeben:

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 DataSize-Wert ist ungültig. Null (0) ist ungültig.
STATUS_INVALID_PARAMETER_3	Der ChainLength-Wert ist ungültig. Null (0) ist ungültig.

Hinweise

Die KMCL stellt sicher, dass Ihre Ringpuffer groß genug sind, um Pakete zu senden, die Puffer in den angegebenen Grenzwerten enthalten.

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

Freigeben über