функция обратного вызова PGET_DMA_ALIGNMENT (wdm.h)
Подпрограмма GetDmaAlignment возвращает требования к выравниванию системы DMA.
Синтаксис
PGET_DMA_ALIGNMENT PgetDmaAlignment;
ULONG PgetDmaAlignment(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Параметры
[in] DmaAdapter
Указатель на структуру DMA_ADAPTER, возвращаемую IoGetDmaAdapter, представляющей адаптер шины или контроллер DMA.
Возвращаемое значение
GetDmaAlignment возвращает требования к выравниванию в байтах системы DMA. Начальный адрес и длина буферов DMA должны быть несколькими из этого значения.
Замечания
GetDmaAlignment не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма вызывается только указателем из адреса, возвращаемого в DMA_OPERATIONS структуре. Драйверы получают адрес этой подпрограммы путем вызова IoGetDmaAdapter.
Драйвер может вызвать эту подпрограмму, чтобы определить требования к выравниванию для буферов DMA, которые он выделяет. Возвращаемое значение следует использовать для задания поля AlignmentRequirement в объекте устройства. Драйвер может потребоваться увеличить это значение из-за дополнительных ограничений аппаратного устройства. Дополнительные сведения см. в инициализации объекта устройства.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | irqlDispatch(wdm) |