DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH fonction de rappel (d3dkmddi.h)

Article
05/26/2023

La fonction DxgkDdiUpdateActiveVidPnPresentPath met à jour l’un des chemins d’accès vidéo présents qui est actuellement actif 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 d’un bloc de contexte associé à une carte d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée au sous-système du noyau graphique Microsoft DirectX dans le paramètre de sortie MiniportDeviceContext 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 et fournissent de nouveaux paramètres pour le chemin. La fonction DxgkDdiUpdateActiveVidPnPresentPath doit programmer le chemin d’accès sur la carte d’affichage en fonction des nouveaux paramètres.

Valeur retournée

DxgkDdiUpdateActiveVidPnPresentPathretourne l’une des valeurs suivantes :

Valeur	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Le chemin spécifié par pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> ne se trouve pas dans la topologie du VidPN actif.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	Le chemin 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 vidéo présents, 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.

Note La fonction DxgkDdiUpdateActiveVidPnPresentPath du pilote miniport 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 d’accès 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 paginable.