FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES Rückruffunktion (vmbuskernelmodeclientlibapi.h)
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 |
|---|---|
|
Der Kanalwert war ungültig oder in einem ungültigen Zustand, z. B. Deaktiviert. |
|
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 |