PEXECUTE_DMA video.h) (回呼函式
HwVidExecuteDma 是一種迷你埠驅動程序實作的回呼例程,負責從散佈/收集清單中擷取實體位址/長度配對,以及設計硬體以啟動實際的 DMA 傳輸。
語法
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
參數
HwDeviceExtension
迷你埠驅動程式每個適配卡儲存區域的指標。 如需詳細資訊,請參閱 裝置延伸模組。
VpDmaAdapter
表示總線主要配接器之 VP_DMA_ADAPTER 結構的指標。 此結構是由 VideoPortGetDmaAdapter的呼叫所傳回。
SGList
VP_SCATTER_GATHER_LIST 結構的指標。 視訊埠驅動程式會填入這個結構中的資訊,並將這個結構傳遞至迷你埠驅動程式。
Context
從 VideoPortStartDma 傳入之驅動程式決定內容的指標。
傳回值
無
備註
此函式可在 Windows XP 和更新版本中使用。
如果迷你埠驅動程序報告裝置不支援散佈/收集,則散佈/收集清單中只會有一個傳遞至此例程的單一元素。 散佈/收集清單有效,直到呼叫 VideoPortCompleteDma 為止。
視訊埠驅動程式的 VideoPortStartDma 函式執行的最後一項工作是呼叫迷你埠驅動程式的 HwVidExecuteDma 回呼例程。 這是實際執行 DMA 傳輸作業的回呼。
HwVidExecuteDma 必須位於非分頁記憶體中,且不得存取任何可分頁的程式代碼或數據。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | video.h (包含 Video.h) |