Compartilhar via

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

  • Artigo

Dxgkrnl chama DxgkDdiQueryDirtyBitData para solicitar uma cópia dos dados de sujo bitplane do KMD (driver de miniporto de exibição no modo kernel).

Sintaxe

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

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 .

pArgs

[entrada/saída] Um ponteiro para uma estrutura DXGKARG_QUERYDIRTYBITDATA que contém informações de entrada e saída para a consulta.

Retornar valor

DxgkDdiQueryDirtyBitData retornará STATUS_SUCCESS se a consulta tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.

Comentários

A função fornece a base de memória e possíveis identificadores de subintervalo para as informações de sujo solicitadas. O KMD deve gravar os dados resultantes no buffer de saída. DxgkDdiQueryDirtyBitData permite consultar todos os intervalos da base de memória ou um único.

Quando a memória estiver prontamente disponível, o Dxgkrnl tentará acelerar essa operação usando uma única chamada para consultar todos os dados necessários de uma só vez. No entanto, em condições de memória baixa, pode ser necessário avançar o progresso usando um buffer de tamanho fixo menor, que é apenas um subconjunto menor da base de memória que está sendo rastreada de uma chamada anterior para DdiStartDirtyTracking. O intervalo de bitplane sujo solicitado nunca excederá um intervalo de sujo controlado ativamente.

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

DXGKARG_QUERYDIRTYBITDATA