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 所追蹤的記憶體基礎子集。 要求的已變更位平面範圍永遠不會超過主動追蹤的中途範圍。

如需詳細資訊，請參閱 中途位追蹤。

規格需求

另請參閱

DXGKARG_QUERYDIRTYBITDATA