FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES fonction de rappel (vmbuskernelmodeclientlibapi.h)
La fonction VmbServerChannelInitSetMmioMegabytes spécifie la quantité, en mégaoctets, de l’espace d’E/S mappé en mémoire invité (MMIO) à réserver pour l’appareil.
Syntaxe
FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;
NTSTATUS FnVmbServerChannelInitSetMmioMegabytes(
VMBCHANNEL Channel,
UINT16 MmioMegabytes,
UINT16 MmioMegabytesOptional
)
{...}
Paramètres
Channel
Handle pour un canal.
MmioMegabytes
Quantité d’espace MMIO, en mégaoctets, à réserver.
MmioMegabytesOptional
Quantité d’espace MMIO facultatif supplémentaire, en mégaoctets, à réserver.
Valeur retournée
VmbServerChannelInitSetMmioMegabytes retourne les valeurs status suivantes :
| Code de retour | Description |
|---|---|
|
La valeur channel n’était pas valide ou dans un état non valide, tel que Désactivé. |
|
MmioMegabytes et MmioMegabytesOptional ont une valeur de zéro (0). L’un de ces paramètres doit être supérieur à zéro |
Remarques
Cette fonction existe en tant que commodité pour les créateurs de pilotes. Tout ce qu’il fait peut être fait en interagissant avec le gestionnaire de plug-and-play invité et en demandant directement de l’espace d’E/S mappé à la mémoire. Il est courant que les pilotes VMBus Windows et Linux aient la capacité de réserver de l’espace MMIO pour le compte du client. Cette fonction permet au point de terminaison du serveur de suggérer la quantité appropriée d’espace MMIO à réserver.
Important
Cette fonction est appelée via l’interface KMCL (Kernel Mode Client Library) VMBus, fournie par le pilote de bus Vmbkmcl.sys. Il s’agit d’une fonction serveur uniquement accessible à partir de la structure KMCL_SERVER_ONLY_METHODS .
Pour plus d’informations, consultez la section Remarques de KMCL_SERVER_ONLY_METHODS.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1809 |
| En-tête | vmbuskernelmodeclientlibapi.h |