PGET_DMA_ADAPTER_INFO Rückruffunktion (wdm.h)

Artikel
02/07/2025

Die GetDmaAdapterInfo Routine ruft Informationen über die Hardwarefunktionen eines System-DMA-Kanals ab.

Syntax

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

Parameter

[in] DmaAdapter

Ein Zeiger auf eine DMA_ADAPTER Struktur. Diese Struktur ist das Adapterobjekt, das den DMA-Kanal des Treibers darstellt. Der Aufrufer hat diesen Zeiger aus einem vorherigen Aufruf an die IoGetDmaAdapter Routine abgerufen.

[in, out] AdapterInfo

Ein Zeiger auf eine vom Aufrufer zugewiesene DMA_ADAPTER_INFO Struktur. Die Routine schreibt Informationen zum DMA-Systemcontroller in diese Struktur. Der Aufrufer muss das Version Member dieser Struktur auf DMA_ADAPTER_INFO_VERSION1 festlegen, bevor GetDmaAdapterInfoaufgerufen wird.

Rückgabewert

GetDmaAdapterInfo gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrücklaufwerte sind der folgende Statuscode.

Rückgabecode	Beschreibung
STATUS_NOT_SUPPORTED	Die Routine unterstützt nicht die angegebene Version der DMA_ADAPTER_INFO_XXX--Struktur.

Bemerkungen

GetDmaAdapterInfo- 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 IoGetDmaAdapter- mit dem Version Member des DeviceDescription-Parameters aufrufen, der auf DEVICE_DESCRIPTION_VERSION3 festgelegt ist. Wenn IoGetDmaAdapterNULL-zurückgibt, ist die Routine auf Ihrer Plattform nicht verfügbar.

GetDmaAdapterInfo ruft die folgenden Informationen ab:

Die maximale Anzahl von Elementen in einer Punkt-/Gather-Liste, die der DMA-Controller in einem einzelnen Punkt/Gather-DMA-Vorgang verarbeiten kann.
Die Breite einer DMA-Adresse in Bits.

Informationen zu den DMA-Adapterinformationen, die von Version 1 der DMA_ADAPTER_INFO_XXX--Struktur bereitgestellt werden, finden Sie unter DMA_ADAPTER_INFO_V1.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL-	<= DISPATCH_LEVEL

Siehe auch

Freigeben über