FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES fonction de rappel (vmbuskernelmodeclientlibapi.h)

  • Article

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
STATUS_INVALID_PARAMETER_1
 La valeur channel n’était pas valide ou dans un état non valide, tel que Désactivé.
STATUS_INVALID_PARAMETER
 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