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

Artigo
02/23/2024

A função DxgkDdiUpdateActiveVidPnPresentPath atualiza um dos caminhos atuais do vídeo que está ativo no adaptador de exibição.

Sintaxe

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

Parâmetros

hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in] pUpdateActiveVidPnPresentPath

Um ponteiro para uma estrutura DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH , que contém um membro: uma estrutura D3DKMDT_VIDPN_PRESENT_PATH . Os membros da estrutura D3DKMDT_VIDPN_PRESENT_PATH identificam o caminho e fornecem novas configurações para o caminho. A função DxgkDdiUpdateActiveVidPnPresentPath deve programar o caminho no adaptador de exibição de acordo com as novas configurações.

Retornar valor

DxgkDdiUpdateActiveVidPnPresentPathretorna um dos seguintes valores:

Valor	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	O caminho especificado por pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> não está na topologia do VidPN ativo.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	O caminho não dá suporte à transformação de conteúdo especificada por pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.ContentTransformation>. O caminho não dá suporte à rampa gama especificada por pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.GammaRamp>.

Comentários

O sistema operacional chama a função DxgkDdiUpdateActiveVidPnPresentPath para controlar as configurações de caminhos presentes em vídeo, como rotação de caminho, transformações de geometria de um conteúdo apresentado, rampas gama usadas para ajustar o brilho do conteúdo apresentado e assim por diante.

Nota A função DxgkDdiUpdateActiveVidPnPresentPath do driver de miniport de exibição deve dar suporte a rampas gama.

Começando com Windows 8, se o driver de miniporto de exibição definir o membro SupportSmoothRotation da estrutura DXGK_DRIVERCAPS, ele deverá dar suporte à atualização da rotação do caminho no adaptador usando a função DxgkDdiUpdateActiveVidPnPresentPath. O driver sempre deve ser capaz de definir a rotação do caminho durante uma chamada para a função DxgkDdiCommitVidPn .

A função DxgkDdiUpdateActiveVidPnPresentPath deve ser tornada paginável.