estructura DMA_TRANSFER_INFO_V1 (wdm.h)
La estructura de DMA_TRANSFER_INFO_V1 contiene los requisitos de asignación de una lista de dispersión y recopilación que describe el búfer de datos de E/S para una transferencia DMA.
Sintaxis
typedef struct _DMA_TRANSFER_INFO_V1 {
ULONG MapRegisterCount;
ULONG ScatterGatherElementCount;
ULONG ScatterGatherListSize;
} DMA_TRANSFER_INFO_V1, *PDMA_TRANSFER_INFO_V1;
Miembros
MapRegisterCount
Número de registros de mapa necesarios para traducir todas las direcciones físicas de la lista de dispersión y recopilación a direcciones lógicas.
ScatterGatherElementCount
Número de elementos de dispersión y recopilación en la lista de dispersión y recopilación. Cada elemento es una estructura de tipo SCATTER_GATHER_ELEMENT.
ScatterGatherListSize
Tamaño necesario, en bytes, del búfer de dispersión y recopilación. Este búfer contiene la lista de dispersión y recopilación que describe la memoria que se usa para almacenar en búfer los datos de E/S durante la transferencia de DMA. El búfer de dispersión y recopilación debe ser lo suficientemente grande como para contener una estructura de SCATTER_GATHER_LIST y una matriz de estructuras de SCATTER_GATHER_ELEMENT , además de datos adicionales que el sistema operativo usa internamente.
Comentarios
El miembro V1 de la estructura DMA_TRANSFER_INFO es una estructura de tipo DMA_TRANSFER_INFO_V1.
Los parámetros Mdl, Offset y Length de la rutina GetDmaTransferInfo describen conjuntamente el búfer de datos de E/S para una transferencia DMA. Para programar un controlador DMA, este búfer puede describirse más convenientemente mediante una lista de dispersión y recopilación. (Una lista de dispersión y recopilación describe la memoria en un búfer de datos de E/S, pero no contiene esta memoria). Un controlador llama a GetDmaTransferInfo para obtener los requisitos de asignación de esta lista de dispersión y recopilación. GetDmaTransferInfo escribe los requisitos de asignación en el miembro V1 de una estructura de DMA_TRANSFER_INFO proporcionada por el autor de la llamada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 8. |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |