PPUT_DMA_ADAPTER Rückruffunktion (wdm.h)
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) |