функция обратного вызова 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) |