estrutura DMA_TRANSFER_INFO_V2 (wdm.h)

  • Artigo

Contém os requisitos de alocação para uma lista de dispersão/coleta que descreve o buffer de dados de E/S para uma transferência de DMA.

Sintaxe

typedef struct _DMA_TRANSFER_INFO_V2 {
  ULONG MapRegisterCount;
  ULONG ScatterGatherElementCount;
  ULONG ScatterGatherListSize;
  ULONG LogicalPageCount;
} DMA_TRANSFER_INFO_V2, *PDMA_TRANSFER_INFO_V2;

Membros

MapRegisterCount

O número de registros de mapa necessários para converter todos os endereços físicos na lista de dispersão/coleta em endereços lógicos.

ScatterGatherElementCount

O número de elementos de dispersão/coleta na lista de dispersão/coleta. Cada elemento é uma estrutura do tipo SCATTER_GATHER_ELEMENT.

ScatterGatherListSize

O tamanho necessário, em bytes, do buffer de dispersão/coleta. Esse buffer contém a lista de dispersão/coleta que descreve a memória usada para armazenar dados de E/S em buffer durante a transferência de DMA. O buffer de dispersão/coleta deve ser grande o suficiente para conter uma estrutura SCATTER_GATHER_LIST e uma matriz de estruturas SCATTER_GATHER_ELEMENT , além de dados adicionais que são usados internamente pelo sistema operacional.

LogicalPageCount

O número de páginas lógicas.

Comentários

O membro V2 da estrutura DMA_TRANSFER_INFO é uma estrutura do tipo DMA_TRANSFER_INFO_V2.

Os parâmetros Mdl, Offset e Length para a rotina GetDmaTransferInfo juntos descrevem o buffer de dados de E/S para uma transferência de DMA. Para a finalidade de programar um controlador de DMA, esse buffer pode ser descrito de forma mais conveniente por uma lista de dispersão/coleta. (Uma lista de dispersão/coleta descreve a memória em um buffer de dados de E/S, mas não contém essa memória.) Um driver chama GetDmaTransferInfo para obter os requisitos de alocação para essa lista de dispersão/coleta. GetDmaTransferInfo grava os requisitos de alocação no membro V1 de uma estrutura de DMA_TRANSFER_INFO fornecida pelo chamador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809.
Cabeçalho wdm.h