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)

Consulte también

DMA_TRANSFER_INFO

GetDmaTransferInfo

SCATTER_GATHER_LIST