FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES Rückruffunktion (vmbuskernelmodeclientlibapi.h)

  • Artikel

Die Funktion VmbServerChannelInitSetMmioMegabytes gibt die Menge (Megabyte) des gastspeicherseitig zugeordneten E/A-Speicherplatzes (MMIO) 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 des zu reservierenden MMIO-Speicherplatzes in Megabyte.

MmioMegabytesOptional

Die Menge des zusätzlichen optionalen MMIO-Speicherplatzes in Megabyte, der reserviert werden soll.

Rückgabewert

VmbServerChannelInitSetMmioMegabytes gibt die folgenden status Werte zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER_1
 Der Kanalwert war ungültig oder in einem ungültigen Zustand, z. B. Deaktiviert.
STATUS_INVALID_PARAMETER
 Sowohl MmioMegabytes als auch MmioMegabytesOptional weisen den Wert 0 (0) auf. Einer dieser Parameter muss größer als 0 sein.

Hinweise

Diese Funktion ist als Benutzerfreundlichkeit für Treiberersteller verfügbar. Alles, was er tut, kann durch Interaktion mit dem Plug-and-Play-Gast-Manager und direktes Anfordern von speicherbezogenem E/A-Speicherplatz erfolgen. Es ist eine häufige Anforderung, dass die Windows- und Linux-VMBus-Treiber über die Kapazität verfügen, MMIO-Speicherplatz im Namen des Clients zu reservieren. Mit dieser Funktion kann der Serverendpunkt die richtige Menge an 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 reine Serverfunktion, 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
Unterstützte Mindestversion (Client) Windows 10, Version 1809
Kopfzeile vmbuskernelmodeclientlibapi.h