Freigeben über


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)

Weitere Informationen

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter