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

Статья
08/08/2023

Подпрограмма 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)

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