DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiUpdateActiveVidPnPresentPath met à jour l’un des chemins d’accès présents vidéo actuellement actifs sur l’adaptateur d’affichage.

Syntaxe

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

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

Paramètres

hAdapter

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

[in] pUpdateActiveVidPnPresentPath

Pointeur vers une structure DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH, qui contient un membre : une structure D3DKMDT_VIDPN_PRESENT_PATH. Les membres de la structure D3DKMDT_VIDPN_PRESENT_PATH identifient le chemin d’accès et fournissent de nouveaux paramètres pour le chemin d’accès. La fonction DxgkDdiUpdateActiveVidPnPresentPath doit programmer le chemin d’accès sur l’adaptateur d’affichage en fonction des nouveaux paramètres.

Valeur de retour

DxgkDdiUpdateActiveVidPnPresentPathretourne l’une des valeurs suivantes :

Valeur	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Chemin d’accès spécifié par pUpdateActiveVidPnPresentPathArg-> VidPnPresentPathInfo n’est pas dans la topologie du VidPN actif.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	Le chemin d’accès ne prend pas en charge la transformation de contenu spécifiée par pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo.ContentTransformation. Le chemin ne prend pas en charge la rampe gamma spécifiée par pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo.GammaRamp.

Remarques

Le système d’exploitation appelle la fonction DxgkDdiUpdateActiveVidPnPresentPath pour contrôler les paramètres des chemins d’accès présents vidéo, tels que la rotation des chemins d’accès, les transformations géométriques d’un contenu présenté, les rampes gamma utilisées pour ajuster la luminosité du contenu présenté, etc.

Remarque La fonction DxgkDdiUpdateActiveVidPnPresentPath du pilote d’affichage doit prendre en charge les rampes gamma.

À compter de Windows 8, si le pilote miniport d’affichage définit le membre SupportSmoothRotation de la structure DXGK_DRIVERCAPS, il doit prendre en charge la mise à jour de la rotation du chemin sur l’adaptateur à l’aide de la fonction DxgkDdiUpdateActiveVidPnPresentPath. Le pilote doit toujours être en mesure de définir la rotation du chemin pendant un appel à la fonction DxgkDdiCommitVidPn.

La fonction DxgkDdiUpdateActiveVidPnPresentPath doit être rendue paginable.