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

Chamado depois que uma nova configuração de sobreposição de vários planos entrou em vigor, permitindo que o driver otimize o estado do hardware. Opcional para drivers WDDM (Windows Display Driver Model) 2.0 ou posteriores que dão suporte a sobreposições de vários planos.

Sintaxe

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Parâmetros

hAdapter

Identifica o adaptador que contém o hardware de sobreposição.

pPostPresent

Um ponteiro para uma estrutura DXGKARG_POSTMULTIPLANEOVERLAYPRESENT que descreve a nova configuração de sobreposição confirmada recentemente.

Retornar valor

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT retorna os seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	Se a rotina tiver sido concluída com êxito. O driver sempre deve retornar um código de êxito. Falhas resultarão em uma verificação de bugs.

Comentários

Essa função é chamada do nível PASSIVE.

Essa função só é chamada quando o driver define PostPresentNeeded de DXGKCB_NOTIFY_MPO_VSYNC_FLAGS membro da estrutura DXGKARGCB_NOTIFY_INTERRUPT_DATA no retorno de chamada VSYNC.

O driver pode usar essa função para reduzir os níveis de tensão, relógios, profundidades FIFO ou qualquer outra otimização que possa economizar energia.

O driver não deve gastar uma quantidade significativa de tempo nessa chamada porque a chamada bloqueia o thread do agendador de GPU main e o atraso pode levar a falhas presentes. As ações com uso intensivo de tempo devem ser enfileiradas como itens de trabalho separados por driver e tratadas em segundo plano. Nesse cenário, todos os conflitos entre o item enfileirado e as alterações de hardware exigidas por futuras chamadas pré/pós devem ser gerenciados pelo driver.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3dkmddi.h