macro ADDRESS_AND_SIZE_TO_SPAN_PAGES (wdm.h)

La macro ADDRESS_AND_SIZE_TO_SPAN_PAGES restituisce il numero di pagine estese dall'intervallo virtuale definito da un indirizzo virtuale e le 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 è la base dell'intervallo.

[in] Size

Specifica le dimensioni in byte della richiesta di trasferimento.

Valore restituito

nessuno

Osservazioni

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

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 causano il overflow della memoria.

Requisiti