структура 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 структур, а также дополнительные данные, используемые операционной системой внутри системы.
Комментарии
Элемент V1 структуры DMA_TRANSFER_INFO является структурой типа DMA_TRANSFER_INFO_V1.
Параметры Mdl, Offset и Lengthподпрограммы GetDmaTransferInfo описывают буфер данных ввода-вывода для передачи DMA. В целях программирования контроллера DMA этот буфер можно более удобно описать с помощью точечной и сборной списка. (Список точечной и сборной описывает память в буфере данных ввода-вывода, но не содержит эту память.) Драйвер вызывает GetDmaTransferInfo , чтобы получить требования к выделению для этого списка точечной и сборной. GetDmaTransferInfo записывает требования к выделению в элемент V1 структуры DMA_TRANSFER_INFO , предоставляемой вызывающим абонентом.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Поддерживается начиная с Windows 8. |
Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |