EVT_WDF_RESERVE_DMA回呼函式 (wdfdmatransaction.h)

[僅適用於 KMDF]

當架構有保留資源執行和釋放交易時，會呼叫 EvtReserveDma 事件回呼函式。保留的資源包括地圖緩存器和 WDM DMA 配接器的鎖定。

語法

EVT_WDF_RESERVE_DMA EvtWdfReserveDma;

void EvtWdfReserveDma(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] PVOID Context
)
{...}

[in] DmaTransaction

DMA 交易物件的句柄，表示已指派 DMA 資源的交易。

[in] Context

先前呼叫 WdfDmaTransactionAllocateResources 中指定的驅動程式內容指標。

無

驅動程式藉由呼叫 WdfDmaTransactionAllocateResources 來註冊 EvtReserveDma 事件回呼函式。

當 DMA 資源已指派給與相關聯的交易對象獨佔使用時，架構會呼叫驅動程式的 EvtReserveDma 事件回呼函式。驅動程式可以在保留此保留時多次初始化和執行交易。

驅動程式通常會初始化，然後從其 EvtReserveDma 事件回呼函式內起始交易。如需保留順序的詳細資訊，請參閱保留 DMA 資源。

驅動程式可以從 EvtReserveDma 內呼叫 WdfDmaTransactionFreeResources。

在早於 Windows 8 的操作系統上，EvtReserveDma 必須與指定封包模式 DMA 啟用器的啟用者搭配使用。從 Windows 8 開始，EvtReserveDma 也可以與指定系統模式 DMA 啟用器的啟用者搭配使用。