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 転送を行うドライバーは、転送要求をデバイス DMA 操作のシーケンスに分割する必要があるかどうかを判断する ADDRESS_AND_SIZE_TO_SPAN_PAGES を呼び出します。

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

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