macro ADDRESS_AND_SIZE_TO_SPAN_PAGES (wdm.h)

A macro ADDRESS_AND_SIZE_TO_SPAN_PAGES retorna o número de páginas estendidas pelo intervalo virtual definido por um endereço virtual e o tamanho em bytes de uma solicitação de transferência.

Sintaxe

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

Parâmetros

[in] Va

Ponteiro para o endereço virtual que é a base do intervalo.

[in] Size

Especifica o tamanho em bytes da solicitação de transferência.

Retornar valor

Nenhum

Comentários

ADDRESS_AND_SIZE_TO_SPAN_PAGES retorna o número de páginas estendidas pelo intervalo virtual começando em Va.

Os drivers que fazem transferências de DMA chamam ADDRESS_AND_SIZE_TO_SPAN_PAGES para determinar se uma solicitação de transferência deve ser dividida em uma sequência de operações de DMA do dispositivo.

Um driver pode usar a constante definida pelo sistema PAGE_SIZE para determinar se o número de bytes a serem transferidos é menor que o tamanho da página de memória virtual da plataforma atual.

Os chamadores de ADDRESS_AND_SIZE_TO_SPAN_PAGES podem estar em execução em qualquer IRQL. O chamador deve garantir que os parâmetros especificados não causem estouro de memória.

Requisitos