PGET_DMA_ADAPTER_INFO Rückruffunktion (wdm.h)

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.

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.

Anforderungen

Siehe auch

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter-