FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA fonction de rappel (vmbuskernelmodeclientlibapi.h)

  • Article

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

La fonction VmbChannelInitSetMaximumExternalData définit la taille maximale et la longueur de chaîne des données décrites par un paquet, mais pas directement envoyées dans le paquet. Autrement dit, la taille maximale de la mémoire tampon décrite par un ExternalDataMdl.

Syntaxe

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Paramètres

Channel

Pointeur vers un canal kmCL (Kernel Mode Client Library).

DataSize

Taille maximale des données externes.

ChainLength

Nombre maximal de descripteurs de mémoire Listes (MDL) dans une chaîne MDL entrante.

Valeur retournée

VmbChannelInitSetMaximumExternalData peut retourner l’une des valeurs status suivantes :

Code de retour Description
STATUS_SUCCESS
 La fonction s’est terminée avec succès.
STATUS_INVALID_PARAMETER_1
 La valeur channel n’était pas valide ou dans un état non valide, par exemple Désactivé.
STATUS_INVALID_PARAMETER_2
 La valeur DataSize n’est pas valide. Zéro (0) n’est pas valide.
STATUS_INVALID_PARAMETER_3
 La valeur ChainLength n’est pas valide. Zéro (0) n’est pas valide.

Remarques

La liste KMCL garantit que vos mémoires tampons en anneau sont suffisamment volumineuses pour envoyer des paquets qui contiennent des mémoires tampons dans les limites spécifiées.

Important

Cette fonction est appelée par le biais de l’interface KMCL (Kernel Mode Client Library) VMBus, fournie par le pilote de bus Vmbkmcl.sys. Il s’agit d’une fonction cliente accessible à partir de la structure KMCL_CLIENT_INTERFACE_V1 .

Pour plus d’informations, consultez la section Remarques du KMCL_CLIENT_INTERFACE_V1.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 version 1803
En-tête vmbuskernelmodeclientlibapi.h