Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der Channel- Wert war ungültig oder in einem ungültigen Zustand, z. B. "Deaktiviert". |
|
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 |