estructura SCATTER_GATHER_LIST (wdm.h)
La estructura SCATTER_GATHER_LIST describe la lista de dispersión y recopilación de una operación DMA.
Sintaxis
typedef struct _SCATTER_GATHER_LIST {
ULONG NumberOfElements;
ULONG_PTR Reserved;
SCATTER_GATHER_ELEMENT Elements[];
} SCATTER_GATHER_LIST, *PSCATTER_GATHER_LIST;
Miembros
NumberOfElements
Especifica el número de elementos de la matriz Elements .
Reserved
Reservado para uso futuro.
Elements
Especifica una matriz de elementos de dispersión y recopilación que componen una lista de dispersión y recopilación. Cada elemento de matriz es una estructura de tipo SCATTER_GATHER_ELEMENT, que se define de la siguiente manera:
typedef struct _SCATTER_GATHER_ELEMENT {
PHYSICAL_ADDRESS Address;
ULONG Length;
ULONG_PTR Reserved;
} SCATTER_GATHER_ELEMENT, *PSCATTER_GATHER_ELEMENT;
La estructura SCATTER_GATHER_ELEMENT especifica la longitud, en bytes, de una región de dispersión o recopilación físicamente contigua y la dirección física inicial de esta región.
Comentarios
Para un controlador que realiza la dispersión o recopilación de DMA, la rutina GetScatterGatherList o BuildScatterGatherList crea una lista de dispersión y recopilación y pasa esta lista a la rutina AdapterListControl del controlador. Esta lista de dispersión y recopilación consta de una estructura de SCATTER_GATHER_LIST que va seguida inmediatamente en la memoria por una matriz de SCATTER_GATHER_ELEMENT . El miembro NumberOfElements de la estructura SCATTER_GATHER_LIST especifica el número de elementos de esta matriz.
Para obtener más información sobre las listas de dispersión y recopilación, vea Uso de Dispersión/Recopilación de DMA.
Requisitos
| Requisito | Valor |
|---|---|
| Header | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |