Partager via

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA fonction de rappel (vmbuskernelmodeclientlibapi.h)

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne 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 une 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 listes de descripteurs de mémoire (MDL) dans une chaîne MDL entrante.

Valeur de retour

VmbChannelInitSetMaximumExternalData peut retourner l’une des valeurs d’état suivantes :

Retourner le code Description
STATUS_SUCCESS
 La fonction s’est terminée correctement.
STATUS_INVALID_PARAMETER_1
 La valeur Channel n’était pas valide ou dans un état non valide, tel que 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 (VmBus Kernel Mode Client Library), 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 de la KMCL_CLIENT_INTERFACE_V1.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1803
d’en-tête vmbuskernelmodeclientlibapi.h
  • Last updated on