PPUT_DMA_ADAPTER Rückruffunktion (wdm.h)

  • Artikel

Die PutDmaAdapter-Routine gibt eine DMA_ADAPTER Struktur frei , die zuvor von IoGetDmaAdapter zugewiesen wurde.

Syntax

PPUT_DMA_ADAPTER PputDmaAdapter;

void PputDmaAdapter(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parameter

[in] DmaAdapter

Zeiger auf die DMA_ADAPTER-Struktur , die freigegeben werden soll.

Rückgabewert

Keine

Bemerkungen

PutDmaAdapter 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.

PutDmaAdapter gibt ein DMA-Adapterobjekt frei, das zuvor von IoGetDmaAdapter zugeordnet wurde. Treiber sollten PutDmaAdapter aufrufen, nachdem sie DMA-Vorgänge abgeschlossen und alle Zuordnungsregister und allgemeinen Puffer freigegeben haben, die diesem Adapterobjekt zugeordnet sind. Nachdem PutDmaAdapter zurückgegeben wurde, kann der Treiber das DMA-Adapterobjekt nicht mehr verwenden.

Ein Treiber muss PutDmaAdapter aufrufen, wenn er eine PnP-IRP_MN_STOP_DEVICE-Anforderung empfängt.

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

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter