PBUILD_MDL_FROM_SCATTER_GATHER_LIST fonction de rappel (wdm.h)

Article
02/27/2024

La routine BuildMdlFromScatterGatherList génère un MDL à partir d’une liste de points/regroupement allouée par le système.

Cette routine est réservée à l’utilisation du système.

Syntaxe

PBUILD_MDL_FROM_SCATTER_GATHER_LIST PbuildMdlFromScatterGatherList;

NTSTATUS PbuildMdlFromScatterGatherList(
  [in]  PDMA_ADAPTER DmaAdapter,
  [in]  PSCATTER_GATHER_LIST ScatterGather,
  [in]  PMDL OriginalMdl,
  [out] PMDL *TargetMdl
)
{...}

Paramètres

[in] DmaAdapter

Pointeur vers la structure DMA_ADAPTER retournée par IoGetDmaAdapter qui représente l’adaptateur master bus ou le contrôleur DMA.

[in] ScatterGather

Pointeur vers la structure SCATTER_GATHER_LIST passée à la routine AdapterListControl du pilote.

[in] OriginalMdl

Pointeur vers le MDL d’origine utilisé par le pilote pour générer la liste de points/regroupements.

[out] TargetMdl

Pointeur vers une variable que la routine utilise pour renvoyer le MDL créé pour contenir la mémoire tampon décrite par la liste de points/regroupements. La valeur retournée peut être identique à OriginalMdl.

Valeur retournée

BuildMdlFromScatterGatherList retourne l’un des codes status suivants :

Code de retour	Description
STATUS_SUCCESS	L’opération a réussi.
STATUS_INVALID_PARAMETER	Le paramètre OriginalMdl a la valeur NULL.
STATUS_INSUFFICIENT_RESOURCES	Il n’y a pas assez de mémoire disponible pour allouer une nouvelle MDL.
STATUS_NONE_MAPPED	Le système a déjà créé une mdl pour les emplacements de mémoire dans la liste de points/regroupements. (Cela se produit uniquement si la routine est appelée deux fois sur la même liste de points/regroupements.)

Remarques

BuildMdlFromScatterGatherList n’est pas une routine système qui peut être appelée directement par nom. Cette routine peut être appelée uniquement par un pointeur à partir de l’adresse retournée dans une structure de DMA_OPERATIONS . Les pilotes obtiennent l’adresse de cette routine en appelant IoGetDmaAdapter avec le membre Version du paramètre DeviceDescription défini sur DEVICE_DESCRIPTION_VERSION2. Si IoGetDmaAdapter retourne NULL, la routine n’est pas disponible sur votre plateforme.

Lorsqu’un pilote crée une liste de points/regroupements pour écrire sur un appareil, le système peut effectuer une copie des données à écrire et utiliser cette copie pour effectuer l’opération DMA. Utilisez cette routine pour accéder aux emplacements de mémoire dans la liste de points/regroupements, qu’il s’agisse ou non d’une copie.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et les versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h (inclure Wdm.h)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	IrqlDispatch(wdm)