Поделиться через


функция обратного вызова PGET_DMA_ALIGNMENT (wdm.h)

Подпрограмма GetDmaAlignment возвращает требования к выравниванию системы DMA.

Синтаксис

PGET_DMA_ALIGNMENT PgetDmaAlignment;

ULONG PgetDmaAlignment(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Параметры

[in] DmaAdapter

Указатель на структуру DMA_ADAPTER, возвращаемую IoGetDmaAdapter, которая представляет адаптер master шины или контроллер DMA.

Возвращаемое значение

GetDmaAlignment возвращает требования к выравниванию (в байтах) системы DMA. Начальный адрес и длина буферов DMA должны быть кратными этому значению.

Комментарии

GetDmaAlignment не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма может вызываться только указателем из адреса, возвращаемого в DMA_OPERATIONS структуре. Драйверы получают адрес этой подпрограммы, вызывая IoGetDmaAdapter.

Драйвер может вызвать эту подпрограмму, чтобы определить требования к выравниванию для выделенных буферов DMA. Возвращаемое значение следует использовать для задания поля AlignmentRequirement в объекте устройства. Драйверу может потребоваться увеличить это значение из-за дополнительных аппаратных ограничений устройств. Дополнительные сведения см. в разделе Инициализация объекта устройства.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
IRQL PASSIVE_LEVEL
Правила соответствия DDI IrqlDispatch(wdm)

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

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter