PREAD_DMA_COUNTER Rückruffunktion (wdm.h)

Artikel
02/29/2024

Die ReadDmaCounter-Routine gibt die Anzahl der Bytes zurück, die während des aktuellen untergeordneten DMA-Vorgangs übertragen werden sollen.

Syntax

PREAD_DMA_COUNTER PreadDmaCounter;

ULONG PreadDmaCounter(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parameter

[in] DmaAdapter

Zeiger auf das Adapterobjekt, das zuvor von IoGetDmaAdapter zurückgegeben wurde, der den derzeit verwendeten DMA-Controllerkanal des Systems darstellt.

Rückgabewert

ReadDmaCounter gibt die Anzahl der Bytes zurück, die im aktuellen DMA-Vorgang übertragen werden sollen.

Hinweise

ReadDmaCounter ist keine Systemroutine, die direkt nach Namen aufgerufen werden kann. Diese Routine kann nur durch den 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.

ReadDmaCounter kann nur von Treibern untergeordneter DMA-Geräte aufgerufen werden. Normalerweise ist der Aufrufer der Treiber eines untergeordneten Geräts, das den Autoinitialisierungsmodus eines System-DMA-Controllers verwendet.

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	<= DISPATCH_LEVEL
DDI-Complianceregeln	IrqlDispatch(wdm)

Weitere Informationen