PPUT_DMA_ADAPTER Rückruffunktion (wdm.h)
Die PutDmaAdapter Routine gibt eine DMA_ADAPTER Struktur frei, die zuvor von IoGetDmaAdapterzugeordnet wurde.
Syntax
PPUT_DMA_ADAPTER PputDmaAdapter;
void PputDmaAdapter(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Parameter
[in] DmaAdapter
Zeigen Sie auf die zu veröffentlichende DMA_ADAPTER Struktur.
Rückgabewert
Nichts
Bemerkungen
PutDmaAdapter- 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 IoGetDmaAdapteraufruft.
PutDmaAdapter ein zuvor von IoGetDmaAdapterzugewiesenes DMA-Adapterobjekt frei. Treiber sollten PutDmaAdapter- aufrufen, nachdem DMA-Vorgänge abgeschlossen wurden, und alle Zuordnungsregister und allgemeinen Puffer freigegeben werden, 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 |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | IrqlDispatch(wdm) |