DXGKDDI_QUERYDIRTYBITDATA回呼函式 (d3dkmddi.h)
Dxgkrnl 會呼叫 DxgkDdiQueryDirtyBitData ,從內核模式顯示迷你埠驅動程式 (KMD) 要求中途位平面數據的複本。
語法
DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;
NTSTATUS DxgkddiQuerydirtybitdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}
參數
hAdapter
[in]與顯示配接器相關聯的內容區塊句柄。 KMD 先前在 DxgiDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中,將此句柄提供給 Dxgkrnl。
pArgs
[in/out]包含查詢輸入和輸出資訊的 DXGKARG_QUERYDIRTYBITDATA 結構的指標。
傳回值
如果查詢成功,DxgkDdiQueryDirtyBitData 會傳回STATUS_SUCCESS。 否則,它會傳回適當的NTSTATUS錯誤碼。
備註
函式會提供所要求中途信息之內存基礎和潛在子範圍標識碼。 KMD 必須將產生的數據寫入輸出緩衝區。 DxgkDdiQueryDirtyBitData 允許查詢記憶體基礎的所有範圍或單一範圍。
當記憶體可供使用時, Dxgkrnl 會嘗試使用單一呼叫來一次查詢所有必要的數據來加速此作業。 不過,在記憶體不足的情況下,可能需要使用較小的固定大小緩衝區進行向前進度,這是從先前呼叫 DdiStartDirtyTracking 所追蹤的記憶體基礎子集。 要求的已變更位平面範圍永遠不會超過主動追蹤的中途範圍。
如需詳細資訊,請參閱 中途位追蹤。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 11 版本 24H2 (WDDM 3.2) |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |