Partilhar via


DXGKDDI_STARTDIRTYTRACKING função de retorno de chamada (d3dkmddi.h)

A função DxgkDdiStartDirtyTracking do KMD permite o acompanhamento de bits sujo no segmento especificado e no intervalo de endereços fornecido.

Sintaxe

DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;

NTSTATUS DxgkddiStartdirtytracking(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

Parâmetros

hAdapter

[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. O KMD forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da funçãoDxgiDdiAddDevice.

hMemoryBasis

[in] Manipule para a base de memória sobre a qual iniciar o acompanhamento de operações sujas. O KMD criou esse identificador em uma chamada anterior para DxgkDdiCreateMemoryBasis.

Valor de retorno

DxgkDdiStartDirtyTracking retorna STATUS_SUCCESS após o sucesso. Caso contrário, ele retornará um código NTSTATUS apropriado.

Observações

O driver só precisa garantir que o rastreamento sujo esteja habilitado para a base de memória especificada. No entanto, fazer isso em uma granularidade grosseira (por exemplo, habilitar o rastreamento sujo para todo o adaptador ou segmento) é válido desde que todas as solicitações pendentes sejam respeitadas.

Dxgkrnl pode habilitar o acompanhamento de páginas sujas em vários segmentos ou intervalos dentro desses segmentos simultaneamente.

Quando o controle sujo estiver habilitado, Dxgkrnl espera que o bitplane sujo seja inicializado para todos os zeros (todas as páginas não modificadas).

Para obter mais informações, consulte de controle de bits sujo .

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 11, versão 24H2 (WDDM 3.2)
cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL

Consulte também

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking