PGET_DMA_ALIGNMENT Rückruffunktion (wdm.h)
Die GetDmaAlignment Routine gibt die Ausrichtungsanforderungen des DMA-Systems zurück.
Syntax
PGET_DMA_ALIGNMENT PgetDmaAlignment;
ULONG PgetDmaAlignment(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Parameter
[in] DmaAdapter
Ein Zeiger auf die DMA_ADAPTER Struktur, die von IoGetDmaAdapter zurückgegeben wird, der den Busmasteradapter oder DMA-Controller darstellt.
Rückgabewert
GetDmaAlignment gibt die Ausrichtungsanforderungen des DMA-Systems in Bytes zurück. Die Startadresse und die Länge von DMA-Puffern müssen ein Vielfaches dieses Werts sein.
Bemerkungen
GetDmaAlignment- ist keine Systemroutine, die direkt anhand des Namens aufgerufen werden kann. Diese Routine kann nur durch Zeiger von der in einer DMA_OPERATIONS Struktur zurückgegebenen Adresse aufgerufen werden. Treiber rufen die Adresse dieser Routine ab, indem sie IoGetDmaAdapteraufruft.
Ein Treiber kann diese Routine aufrufen, um die Ausrichtungsanforderungen für DMA-Puffer zu bestimmen, die zugewiesen werden. Der zurückgegebene Wert sollte verwendet werden, um das AlignmentRequirement Feld im Geräteobjekt festzulegen. Ein Treiber muss diesen Wert möglicherweise aufgrund zusätzlicher Hardwaregeräteeinschränkungen erhöhen. Weitere Informationen finden Sie unter Initialisieren eines Device-Objekts.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | IrqlDispatch(wdm) |