FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

Die VmbServerChannelInitSetMmioMegabytes-Funktion gibt die Menge, Megabytes von E/A(MMIO)-Speicher für Gastspeicher an, der für das Gerät reserviert werden soll.

Syntax

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

NTSTATUS FnVmbServerChannelInitSetMmioMegabytes(
  VMBCHANNEL Channel,
  UINT16 MmioMegabytes,
  UINT16 MmioMegabytesOptional
)
{...}

Parameter

Channel

Ein Handle für einen Kanal.

MmioMegabytes

Die Menge an MMIO-Speicherplatz in Megabyte, die reserviert werden soll.

MmioMegabytesOptional

Die Menge an zusätzlichem optionalem MMIO-Speicherplatz in Megabyte, die reserviert werden soll.

Rückgabewert

VmbServerChannelInitSetMmioMegabytes gibt die folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER_1	Der Channel- Wert war ungültig oder in einem ungültigen Zustand, z. B. "Deaktiviert".
STATUS_INVALID_PARAMETER	Sowohl mmioMegabytes als auch MmioMegabytesOptional einen Wert von Null (0) aufweisen. Einer dieser Parameter muss größer als 0 sein.

Bemerkungen

Diese Funktion ist als Komfort für Treiberersteller vorhanden. Alles, was dies tut, kann durch die Interaktion mit dem Gast-Plug-and-Play-Manager und durch direktes Anfordern von speicherzuordnungen E/A-Speicherplatz erfolgen. Es ist eine häufige Anforderung, dass die Windows- und Linux-VMBus-Treiber die Kapazität haben, MMIO-Speicherplatz im Auftrag des Clients zu reservieren. Mit dieser Funktion kann der Serverendpunkt den richtigen MMIO-Speicherplatz vorschlagen, der reserviert werden soll.

Wichtig

Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine servergeschützte Funktion, auf die über die KMCL_SERVER_ONLY_METHODS-Struktur zugegriffen wird.

Weitere Informationen finden Sie im Abschnitt "Hinweise" von KMCL_SERVER_ONLY_METHODS.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1809
Header-	vmbuskernelmodeclientlibapi.h

Freigeben über