FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

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

Syntax

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

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

Parameter

Channel

Ein Zeiger auf einen Kernelmodus-Clientbibliothekskanal (KERNEL Mode Client Library, KMCL).

DataSize

Die maximale Größe externer Daten.

ChainLength

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

Rückgabewert

VmbChannelInitSetMaximumExternalData- kann einen der folgenden Statuswerte zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER_1	Der Channel- Wert 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.

Bemerkungen

Die KMCL stellt sicher, dass die 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
mindestens unterstützte Client-	Windows 10, Version 1803
Header-	vmbuskernelmodeclientlibapi.h

Freigeben über