Condividi tramite

struttura DMA_TRANSFER_INFO_V2 (wdm.h)

  • Articolo

Contiene i requisiti di allocazione per un elenco a dispersione/raccolta che descrive il buffer dei dati di I/O per un trasferimento DMA.

Sintassi

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

Membri

MapRegisterCount

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

ScatterGatherElementCount

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

ScatterGatherListSize

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

LogicalPageCount

Numero di pagine logiche.

Osservazioni

Il membro V2 della struttura DMA_TRANSFER_INFO è una struttura di tipo DMA_TRANSFER_INFO_V2.

I parametri Mdl, Offsete Length alla routine GetDmaTransferInfo descrivono insieme il buffer di dati di I/O per un trasferimento DMA. Ai fini della programmazione di un controller DMA, questo buffer può essere descritto più facilmente da un elenco a 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 a dispersione/raccolta. GetDmaTransferInfo scrive i requisiti di allocazione nel membro V1 di una struttura di DMA_TRANSFER_INFO fornita dal chiamante.

Fabbisogno

Requisito Valore
client minimo supportato Windows 10, versione 1809.
intestazione wdm.h