macro ADDRESS_AND_SIZE_TO_SPAN_PAGES (wdm.h)

La macro ADDRESS_AND_SIZE_TO_SPAN_PAGES restituisce il numero di pagine estese da un intervallo virtuale. L'intervallo virtuale è definito da un indirizzo virtuale e dalle dimensioni in byte di una richiesta di trasferimento.

Sintassi

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

Parametri

[in] Va

Puntatore all'indirizzo virtuale che rappresenta la base dell'intervallo.

[in] Size

Specifica le dimensioni in byte della richiesta di trasferimento.

Valore restituito

Restituisce il numero di pagine estese dall'intervallo virtuale a partire da Va.

Osservazioni

I driver che effettuano trasferimenti DMA chiamano ADDRESS_AND_SIZE_TO_SPAN_PAGES per determinare se una richiesta di trasferimento deve essere suddivisa in una sequenza di operazioni DMA del dispositivo.

Un driver può usare la costante definita dal sistema PAGE_SIZE per determinare se il numero di byte da trasferire è minore delle dimensioni della pagina di memoria virtuale della piattaforma corrente.

I chiamanti di ADDRESS_AND_SIZE_TO_SPAN_PAGES possono essere in esecuzione in qualsiasi IRQL. Il chiamante deve assicurarsi che i parametri specificati non causi l'overflow della memoria.

Fabbisogno