macro ADDRESS_AND_SIZE_TO_SPAN_PAGES (wdm.h)

La macro ADDRESS_AND_SIZE_TO_SPAN_PAGES retourne le nombre de pages qu’une plage virtuelle s’étend. La plage virtuelle est 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

Retourne le nombre de pages étendues par la plage virtuelle commençant à Va.

Remarques

Les pilotes qui effectuent des transferts DMA ADDRESS_AND_SIZE_TO_SPAN_PAGES pour déterminer si une demande de transfert doit être divisé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 s’exécuter à n’importe quel runtime IRQL. L’appelant doit s’assurer que les paramètres spécifiés ne provoquent pas de dépassement de mémoire.

Exigences