PPUT_DMA_ADAPTER回呼函式 (wdm.h)
PutDmaAdapter 例程會釋放先前由IoGetDmaAdapter配置的DMA_ADAPTER結構。
語法
PPUT_DMA_ADAPTER PputDmaAdapter;
void PputDmaAdapter(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
參數
[in] DmaAdapter
要釋放 之DMA_ADAPTER 結構的指標。
傳回值
無
備註
PutDmaAdapter 不是可直接依名稱呼叫的系統例程。 這個例程只能由 DMA_OPERATIONS結構中 傳回之位址的指標呼叫。 驅動程式會呼叫 IoGetDmaAdapter來取得此例程的位址。
PutDmaAdapter 釋出先前由 IoGetDmaAdapter配置的 DMA 配接器物件。 驅動程式在完成 DMA 作業並釋放任何對應緩存器和使用此配接器物件配置的通用緩衝區之後,應該呼叫 PutDmaAdapter 。 PutDmaAdapter 傳回之後,驅動程式就無法再使用 DMA 配接器物件。
驅動程式在收到 PnP IRP_MN_STOP_DEVICE 要求時,必須呼叫 PutDmaAdapter。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | IrqlDispatch (wdm) |