DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH función de devolución de llamada (d3dkmddi.h)

Artículo
02/26/2024

La función DxgkDdiUpdateActiveVidPnPresentPath actualiza una de las rutas de acceso del vídeo que está actualmente activa en el adaptador de pantalla.

Sintaxis

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

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

Parámetros

hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

[in] pUpdateActiveVidPnPresentPath

Puntero a una estructura DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH , que contiene un miembro: una estructura D3DKMDT_VIDPN_PRESENT_PATH . Los miembros de la estructura D3DKMDT_VIDPN_PRESENT_PATH identifican la ruta de acceso y proporcionan una nueva configuración para la ruta de acceso. La función DxgkDdiUpdateActiveVidPnPresentPath debe programar la ruta de acceso en el adaptador de pantalla según la nueva configuración.

Valor devuelto

DxgkDdiUpdateActiveVidPnPresentPathdevuelve uno de los siguientes valores:

Valor	Descripción
STATUS_SUCCESS	La función se ha realizado correctamente.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	La ruta de acceso especificada por pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> no está en la topología del VidPN activo.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	La ruta de acceso no admite la transformación de contenido especificada por pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.ContentTransformation>. La ruta de acceso no admite la rampa gamma especificada por pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.GammaRamp>.

Comentarios

El sistema operativo llama a la función DxgkDdiUpdateActiveVidPnPresentPath para controlar la configuración de las rutas de acceso de vídeo presentes, como la rotación de rutas de acceso, las transformaciones de geometría de un contenido presentado, las rampas gamma que se usan para ajustar el brillo del contenido presentado, etc.

Nota La función DxgkDdiUpdateActiveVidPnPresentPath del controlador de minipuerto de pantalla debe admitir rampas gamma.

A partir de Windows 8, si el controlador de minipuerto de pantalla establece el miembro SupportSmoothRotation de la estructura DXGK_DRIVERCAPS, debe admitir la actualización de la rotación de rutas en el adaptador mediante la función DxgkDdiUpdateActiveVidPnPresentPath. El controlador siempre debe ser capaz de establecer la rotación de la ruta de acceso durante una llamada a la función DxgkDdiCommitVidPn .

La función DxgkDdiUpdateActiveVidPnPresentPath debe ser paginable.