FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES fonction de rappel (vmbuskernelmodeclientlibapi.h)
La fonction VmbServerChannelInitSetMmioMegabytes spécifie la quantité, 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é supplémentaire d’espace MMIO facultatif, en mégaoctets, à réserver.
Valeur de retour
VmbServerChannelInitSetMmioMegabytes retourne les valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
La valeur Channel n’était pas valide ou dans un état non valide, tel que Désactivé. |
|
Les deux MmioMegabytes et mmioMegabytesOptional ont la valeur zéro (0). L’un de ces paramètres doit être supérieur à zéro |
Remarques
Cette fonction existe comme une commodité pour les créateurs de pilotes. Tout ce qu’il peut faire peut être effectué en interagissant directement avec le gestionnaire de plug-and-play invité et en demandant directement l’espace d’E/S mappé en 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 par le biais de l’interface KMCL (VmBus Kernel Mode Client Library), 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1809 |
| d’en-tête | vmbuskernelmodeclientlibapi.h |