DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 função de retorno de chamada (d3dkmddi.h)
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 é chamado para alterar a configuração de sobreposição que está sendo exibida.
Sintaxe
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;
NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
IN_CONST_HANDLE hAdapter,
IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}
Parâmetros
hAdapter
Identifica o adaptador que contém o hardware de sobreposição.
pSetVidPnSourceAddressWithMultiPlaneOverlay
Um ponteiro para uma estrutura DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 que descreve as superfícies e as opções de exibição a serem apresentadas.
Retornar valor
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 retorna os seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A rotina foi concluída com êxito. |
| STATUS_INVALID_PARAMETER | No [modelo de fila de inversão de hardware]/windows-hardware/drivers/display/hardware-flip-queue), o driver não pôde processar uma solicitação de inversão. |
| STATUS_RETRY | Retornado por motivos como o driver não conseguiu enfileirar uma solicitação para o hardware devido a inversões pendentes ou o driver precisa ser chamado no PASSIVE_LEVEL. Se o driver precisar ser chamado em PASSIVE_LEVEL ele também deverá definir o DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Sinalizador PrePresentNeeded . |
Comentários
Essa função normalmente é chamada no nível de interrupção, mas se o driver precisar executar a configuração de hardware que só pode ser executada em PASSIVE_LEVEL, o driver poderá solicitar que essa função seja recolhida em PASSIVE_LEVEL retornando STATUS_RETRY e definindo o DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Sinalizador PrePresentNeeded .
Mesmo quando chamado em PASSIVE_LEVEL, o driver deve evitar 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 pelo 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 |