struttura DMA_TRANSFER_INFO_V1 (wdm.h)

La struttura DMA_TRANSFER_INFO_V1 contiene i requisiti di allocazione per un elenco di dispersione/raccolta che descrive il buffer dei dati di I/O per un trasferimento DMA.

Sintassi

typedef struct _DMA_TRANSFER_INFO_V1 {
  ULONG MapRegisterCount;
  ULONG ScatterGatherElementCount;
  ULONG ScatterGatherListSize;
} DMA_TRANSFER_INFO_V1, *PDMA_TRANSFER_INFO_V1;

Members

MapRegisterCount

Numero di registri mappa necessari per convertire tutti gli indirizzi fisici nell'elenco di dispersione/raccolta in indirizzi logici.

ScatterGatherElementCount

Numero di elementi di dispersione/raccolta nell'elenco di dispersione/raccolta. Ogni elemento è una struttura di tipo SCATTER_GATHER_ELEMENT.

ScatterGatherListSize

Dimensioni necessarie, in byte, del buffer di dispersione/raccolta. Questo buffer contiene l'elenco di dispersione/raccolta che descrive la memoria usata per bufferre i dati di I/O durante il trasferimento DMA. Il buffer a dispersione/raccolta deve essere abbastanza grande per contenere una struttura SCATTER_GATHER_LIST e una matrice di strutture SCATTER_GATHER_ELEMENT , oltre a dati aggiuntivi usati internamente dal sistema operativo.

Commenti

Il membro V1 della struttura DMA_TRANSFER_INFO è una struttura di tipo DMA_TRANSFER_INFO_V1.

I parametri Mdl, Offset e Length nella routine GetDmaTransferInfo descrivono insieme il buffer di dati di I/O per un trasferimento DMA. Allo scopo di programmare un controller DMA, questo buffer può essere descritto in modo più pratico da un elenco di dispersione/raccolta. Un elenco a dispersione/raccolta descrive la memoria in un buffer di dati di I/O, ma non contiene questa memoria. Un driver chiama GetDmaTransferInfo per ottenere i requisiti di allocazione per questo elenco di dispersione/raccolta. GetDmaTransferInfo scrive i requisiti di allocazione nel membro V1 di una struttura di DMA_TRANSFER_INFO fornita dal chiamante.

Requisiti

Vedi anche

DMA_TRANSFER_INFO

GetDmaTransferInfo

SCATTER_GATHER_LIST