macro ADDRESS_AND_SIZE_TO_SPAN_PAGES (wdm.h)

La macro ADDRESS_AND_SIZE_TO_SPAN_PAGES retourne le nombre de pages délimitées par la plage virtuelle définie par une adresse virtuelle et la taille en octets d’une demande de transfert.

Syntaxe

void ADDRESS_AND_SIZE_TO_SPAN_PAGES(
  [in]  Va,
  [in]  Size
);

Paramètres

[in] Va

Pointeur vers l’adresse virtuelle qui est la base de la plage.

[in] Size

Spécifie la taille en octets de la demande de transfert.

Valeur de retour

None

Remarques

ADDRESS_AND_SIZE_TO_SPAN_PAGES retourne le nombre de pages délimitées par la plage virtuelle à partir de Va.

Les pilotes qui effectuent des transferts DMA appellent ADDRESS_AND_SIZE_TO_SPAN_PAGES pour déterminer si une demande de transfert doit être fractionnée en une séquence d’opérations DMA d’appareil.

Un pilote peut utiliser la constante définie par le système PAGE_SIZE pour déterminer si le nombre d’octets à transférer est inférieur à la taille de page de mémoire virtuelle de la plateforme actuelle.

Les appelants de ADDRESS_AND_SIZE_TO_SPAN_PAGES peuvent être en cours d’exécution à n’importe quel IRQL. L’appelant doit s’assurer que les paramètres spécifiés ne provoquent pas de dépassement de mémoire.

Configuration requise