共用方式為


PFREE_ADAPTER_CHANNEL回呼函式 (wdm.h)

當驅動程式完成滿足目前 IRP 所需的所有 DMA 作業時,FreeAdapterChannel 例程會釋放系統 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 所配置的任何地圖緩存器。 只有當驅動程式 AdapterControl 例程傳回 keepObject 時,驅動程式才會呼叫此例程。

要求

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

另請參閱

AllocateAdapterChannel

DMA_ADAPTER

DMA_OPERATIONS

FlushAdapterBuffers

FreeMapRegisters

IoGetDmaAdapter

MapTransfer