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 追蹤記憶體基礎的較小子集。 要求的臟位平面範圍永遠不會超過主動追蹤的骯髒範圍。
如需詳細資訊，請參閱 Dirty 位追蹤。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 版本 24H2 （WDDM 3.2） |
| 標頭 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |