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

転送要求のサイズをバイト単位で指定します。

なし

ADDRESS_AND_SIZE_TO_SPAN_PAGES からは、Va から始まる仮想範囲にまたがるページ数が返されます。

DMA 転送を行うドライバーにより ADDRESS_AND_SIZE_TO_SPAN_PAGES が呼び出され、転送要求を一連のデバイス DMA 操作に分割する必要があるかどうかが判断されます。

ドライバーでは、システム定義定数 PAGE_SIZE を使用して、転送されるバイト数が現在のプラットフォームの仮想メモリページサイズよりも小さいかどうかを判断できます。

ADDRESS_AND_SIZE_TO_SPAN_PAGES の呼び出し元は、どの IRQL で実行されていてもかまいません。呼び出し元は、指定したパラメーターによってメモリオーバーフローが確実に発生しないようにする必要があります。