структура SCATTER_GATHER_LIST (wdm.h)
Структура SCATTER_GATHER_LIST описывает список точечной или сборной для операции DMA.
Синтаксис
typedef struct _SCATTER_GATHER_LIST {
ULONG NumberOfElements;
ULONG_PTR Reserved;
SCATTER_GATHER_ELEMENT Elements[];
} SCATTER_GATHER_LIST, *PSCATTER_GATHER_LIST;
Члены
NumberOfElements
Указывает количество элементов в массиве элементов.
Reserved
Зарезервировано для дальнейшего использования.
Elements
Задает массив элементов точечной или сборной, составляющих список точечной или сборной. Каждый элемент массива представляет собой структуру типа SCATTER_GATHER_ELEMENT, которая определяется следующим образом:
typedef struct _SCATTER_GATHER_ELEMENT {
PHYSICAL_ADDRESS Address;
ULONG Length;
ULONG_PTR Reserved;
} SCATTER_GATHER_ELEMENT, *PSCATTER_GATHER_ELEMENT;
Структура SCATTER_GATHER_ELEMENT указывает длину (в байтах) физического точечных или сборных регионов и начального физического адреса этого региона.
Замечания
Для драйвера, выполняющего точечную или сборную DMA, GetScatterGatherList или BuildScatterGatherList создает список точечной и сборной и передает этот список в подпрограмму АдаптерList Control драйвера. Этот список точечной и сборной состоит из SCATTER_GATHER_LIST структуры, которая сразу же следует за памятью массивом SCATTER_GATHER_ELEMENT. Количество элементов в этом массиве указывается элементом NumberOfElements структуры SCATTER_GATHER_LIST.
Дополнительные сведения о списках точечной и сборной см. в использование точечной и сборнойDMA.
Требования
| Требование | Ценность |
|---|---|
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |