PFREE_ADAPTER_CHANNEL回呼函式 (wdm.h)

FreeAdapterChannel 例程會在驅動程式完成滿足目前 IRP 所需的所有 DMA 作業時，釋放系統 DMA 控制器。

語法

PFREE_ADAPTER_CHANNEL PfreeAdapterChannel;

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

[in] DmaAdapter

IoGetDmaAdapter 所傳回之DMA_ADAPTER結構的指標，代表總線主機適配卡或 DMA 控制器。

無

FreeAdapterChannel 不是可直接依名稱呼叫的系統例程。這個例程只能由 DMA_OPERATIONS結構中傳回之位址的指標呼叫。驅動程式會呼叫 IoGetDmaAdapter來取得此例程的位址。

驅動程式傳輸所有數據並呼叫 FlushAdapterBuffers 之後，它會呼叫 FreeAdapterChannel ，以釋放先前配置給 AllocateAdapterChannel 的系統 DMA 控制器。

FreeAdapterChannel 會釋放先前呼叫 AllocateAdapterChannel 所配置的任何地圖緩存器。只有在 DriverControl 例程傳回 KeepObject 時，驅動程式才會呼叫此例程。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	桌面
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL	DISPATCH_LEVEL
DDI 合規性規則	IrqlDispatch (storport) 、IrqlDispatch (storport ) 、 IrqlDispatch (wdm)