DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione dxgkDdiUpdateActiveVidPnPresentPath aggiorna uno dei percorsi presenti nel video attualmente attivo nella scheda di visualizzazione.

Sintassi

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

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

Parametri

hAdapter

Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.

[in] pUpdateActiveVidPnPresentPath

Puntatore a una struttura DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH, che contiene un membro: una struttura D3DKMDT_VIDPN_PRESENT_PATH. I membri della struttura D3DKMDT_VIDPN_PRESENT_PATH identificano il percorso e forniscono nuove impostazioni per il percorso. La funzione dxgkDdiUpdateActiveVidPnPresentPath deve programmare il percorso sulla scheda di visualizzazione in base alle nuove impostazioni.

Valore restituito

DxgkDdiUpdateActiveVidPnPresentPathrestituisce uno dei valori seguenti:

Valore	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Percorso specificato da pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo non si trova nella topologia del VidPN attivo.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	Il percorso non supporta la trasformazione del contenuto specificata da pUpdateActiveVidPresentPathArg->VidPnPresentPathInfo.ContentTransformation. Il percorso non supporta la rampa gamma specificata da pUpdateActiveVidPathArg->VidPnPresentPathInfo.GammaRamp.

Osservazioni

Il sistema operativo chiama la funzione DxgkDdiUpdateActiveVidPnPresentPath per controllare le impostazioni dei percorsi di presentazione video, ad esempio la rotazione del percorso, le trasformazioni geometriche di un contenuto presentato, le rampe gamma usate per regolare la luminosità del contenuto presentato e così via.

Nota La funzione di dxgkDdiUpdateActiveVidPresentPath del driver di miniport display deve supportare le rampe gamma.

A partire da Windows 8, se il driver miniport di visualizzazione imposta il SupportSmoothRotation membro della struttura DXGK_DRIVERCAPS, deve supportare l'aggiornamento della rotazione del percorso sulla scheda usando la funzione DxgkDdiUpdateActiveVidPnPresentPath. Il driver deve sempre essere in grado di impostare la rotazione del percorso durante una chiamata alla funzione DxgkDdiCommitVidPn.

La funzione DxgkDdiUpdateActiveVidPnPresentPath deve essere resa pageable.