DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

La funzione DxgkDdiUpdateActiveVidPresentPath aggiorna uno dei percorsi del video attualmente attivi nella scheda di visualizzazione.

Sintassi

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

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

Parametri

hAdapter

Handle a un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext 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 nella scheda di visualizzazione in base alle nuove impostazioni.

Valore restituito

DxgkDdiUpdateActiveVidPresentPathrestituisce uno dei valori seguenti:

Valore	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Il percorso specificato da pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> non è 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 pUpdateActiveVidPresentPathArg-VidPnPresentPathInfo.GammaRamp>.

Commenti

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

Nota La funzione DxgkDdiUpdateActiveVidPresentPath del driver di visualizzazione deve supportare le rampe gamma.

A partire da Windows 8, se il driver miniport visualizzato imposta il membro SupportSmoothRotation della struttura DXGK_DRIVERCAPS, deve supportare l'aggiornamento della rotazione del percorso nella scheda usando la funzione DxgkDdiUpdateActiveVidPresentPath. 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 paginabile.