макрос ADDRESS_AND_SIZE_TO_SPAN_PAGES (wdm.h)

Макрос ADDRESS_AND_SIZE_TO_SPAN_PAGES возвращает количество страниц, охватывающих виртуальный диапазон. Виртуальный диапазон определяется виртуальным адресом и размером в байтах запроса на передачу.

Синтаксис

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

Параметры

[in] Va

Указатель на виртуальный адрес, который является базой диапазона.

[in] Size

Задает размер в байтах запроса на передачу.

Возвращаемое значение

Возвращает количество страниц, охватываемых виртуальным диапазоном, начиная с Va.

Замечания

Драйверы, которые делают вызов передачи DMA ADDRESS_AND_SIZE_TO_SPAN_PAGES, чтобы определить, должен ли запрос на передачу разделиться на последовательность операций DMA устройства.

Драйвер может использовать системную константу PAGE_SIZE, чтобы определить, меньше ли количество передаваемых байтов, чем размер страницы виртуальной памяти текущей платформы.

Вызывающие ADDRESS_AND_SIZE_TO_SPAN_PAGES могут работать в любом IRQL. Вызывающий объект должен убедиться, что указанные параметры не вызывают переполнения памяти.

Требования