структура 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)

См. также раздел

DMA_TRANSFER_INFO

GetDmaTransferInfo

SCATTER_GATHER_LIST