структура DMA_TRANSFER_INFO_V1 (wdm.h)
Структура DMA_TRANSFER_INFO_V1 содержит требования к выделению для списка точечной и сборной данных, описывающего буфер данных ввода-вывода для передачи DMA.
Синтаксис
typedef struct _DMA_TRANSFER_INFO_V1 {
ULONG MapRegisterCount;
ULONG ScatterGatherElementCount;
ULONG ScatterGatherListSize;
} DMA_TRANSFER_INFO_V1, *PDMA_TRANSFER_INFO_V1;
Члены
MapRegisterCount
Количество регистров карты, необходимых для перевода всех физических адресов в списке точечных и сборных данных в логические адреса.
ScatterGatherElementCount
Количество элементов точечной и сборной в списке точечной и сборной. Каждый элемент представляет собой структуру типа SCATTER_GATHER_ELEMENT.
ScatterGatherListSize
Требуемый размер в байтах буфера точечной и сборной. Этот буфер содержит список точечной или сборной, описывающий память, используемую для буферизации данных ввода-вывода во время передачи DMA. Буфер точечной и сборной должен быть достаточно большим, чтобы содержать структуру SCATTER_GATHER_LIST и массив структур SCATTER_GATHER_ELEMENT, а также дополнительные данные, используемые внутренне операционной системой.
Замечания
Элемент версии 1 структуры DMA_TRANSFER_INFO является структурой типа DMA_TRANSFER_INFO_V1.
Параметры Mdl, Offsetи Lengthв подпрограмму GetDmaTransferInfo описывают буфер данных ввода-вывода для передачи DMA. Для программирования контроллера DMA этот буфер можно более удобно описать в списке точечной и сборной. (Список точечной и сборной описывает память в буфере данных ввода-вывода, но не содержит эту память.) Драйвер вызывает GetDmaTransferInfo, чтобы получить требования к выделению для этого списка точечной или сборной. GetDmaTransferInfo записывает требования к выделению в версии 1 член структуры, предоставленной вызывающим DMA_TRANSFER_INFO.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 8. |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |