PGET_DMA_ALIGNMENT Rückruffunktion (wdm.h)

Artikel
02/27/2024

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