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 und den Bus-master-Adapter oder DMA-Controller darstellt.
Rückgabewert
GetDmaAlignment gibt die Ausrichtungsanforderungen des DMA-Systems in Bytes zurück. Die Startadresse und Länge von DMA-Puffern muss ein Vielfaches dieses Werts sein.
Hinweise
GetDmaAlignment ist keine Systemroutine, die direkt mit dem Namen aufgerufen werden kann. Diese Routine kann nur durch zeiger von der Adresse aufgerufen werden, die in einer DMA_OPERATIONS-Struktur zurückgegeben wird. Treiber erhalten die Adresse dieser Routine, indem sie IoGetDmaAdapter aufrufen.
Ein Treiber kann diese Routine aufrufen, um die Ausrichtungsanforderungen für die zugeordneten DMA-Puffer zu bestimmen. Der zurückgegebene Wert sollte verwendet werden, um das Feld AlignmentRequirement im Geräteobjekt festzulegen. Möglicherweise muss ein Treiber diesen Wert aufgrund zusätzlicher Hardwaregeräteeinschränkungen erhöhen. Weitere Informationen finden Sie unter Initialisieren eines Geräteobjekts.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Desktop |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | IrqlDispatch(wdm) |