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

A função DxgkDdiUpdateActiveVidPnPresentPath atualiza um dos caminhos presentes no 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 na função 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.

Valor de retorno

DxgkDdiUpdateActiveVidPnPresentPath retorna 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.

Observações

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.

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

 

A partir do Windows 8, se o driver de miniporto de exibição definir o SupportSmoothRotation membro 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 disponibilizada por página.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte também

D3DKMDT_VIDPN_PRESENT_PATH

DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH

DXGK_DRIVERCAPS

DxgkDdiAddDevice

DxgkDdiCommitVidPn