Compartilhar via


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

A função DxgkDdiStartDirtyTracking do KMD permite sujo acompanhamento de bits dentro do segmento especificado e do 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ção DxgiDdiAddDevice .

hMemoryBasis

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

Retornar valor

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

Comentários

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

O Dxgkrnl pode habilitar sujo acompanhamento de página em vários segmentos ou intervalos dentro desses segmentos simultaneamente.

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

Para obter mais informações, consulte Rastreamento de bits sujos.

Requisitos

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

Confira também

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking