PGET_DMA_ADAPTER_INFO Rückruffunktion (wdm.h)

Artikel
08/08/2023

Die GetDmaAdapterInfo-Routine ruft Informationen zu den Hardwarefunktionen eines DMA-Systemkanals 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-Systemkanal des Treibers darstellt. Der Aufrufer hat diesen Zeiger aus einem vorherigen Aufruf der IoGetDmaAdapter-Routine abgerufen.

[in, out] AdapterInfo

Ein Zeiger auf eine aufruferseitig zugeordnete DMA_ADAPTER_INFO-Struktur . Die Routine schreibt Informationen zum DMA-Controller des Systems in diese Struktur. Der Aufrufer muss den Versionsmember dieser Struktur auf DMA_ADAPTER_INFO_VERSION1 festlegen, bevor GetDmaAdapterInfo aufgerufen wird.

Rückgabewert

GetDmaAdapterInfo gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrückgabewerte sind der folgende status Code.

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

Hinweise

GetDmaAdapterInfo 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, wobei der Version-Member des DeviceDescription-Parameters 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 Scatter-/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
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Desktop
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen