DXGKDDI_CONTROLINTERRUPT3 funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione DxgkDdi_ControlInterrupt3 abilita o disabilita il tipo di interrupt specificato per il VidPnSourceId specificato nell'hardware grafico.

Sintassi

DXGKDDI_CONTROLINTERRUPT3 DxgkddiControlinterrupt3;

NTSTATUS DxgkddiControlinterrupt3(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_CONTROLINTERRUPT3 InterruptControl
)
{...}

Parametri

[in] hAdapter

Handle per l'oggetto adapter per l'unità di elaborazione grafica (GPU). Il driver ha restituito questo handle nel parametro MiniportDeviceContext da una chiamata alla relativa funzione DxgkDdiAddDevice.

[in] InterruptControl

Struttura DXGKARG_CONTROLINTERRUPT3 che fornisce il tipo di interrupt, lo stato VSYNC e VidPnSourceId.

Valore restituito

DxgkDdi_ControlInterrupt3 restituisce uno dei valori seguenti:

codice restituito	Descrizione
STATUS_SUCCESS	Il tipo di interrupt è stato abilitato o disabilitato correttamente nell'hardware grafico.
STATUS_NOT_IMPLEMENTED	DxgkDdi_ControlInterrupt3 non supporta l'abilitazione o la disabilitazione del tipo di interrupt specificato.

Osservazioni

Il controllo VSync viene usato in WDDM per attivare o disattivare VSync on e OFF per bilanciare l'utilizzo attivo di un'origine VidPn da uno scenario e il risparmio di energia ottenuto disattivando VSync. In generale, il sistema operativo controlla la logica di quando VSync deve rimanere ON e OFF e notifica al driver in modalità kernel IHV (KMD) tramite una chiamata DDI. Il KMD esegue la richiesta. Prima di Windows 10, versione 2004 (WDDM 2.7), la granularità del controllo VSync è per scheda; vale a dire, per una determinata scheda, il controllo VSync si applica a ogni origine VidPn dell'adattatore. Si consideri, ad esempio, un adattatore con due origini VidPn connesse a due output diversi. Se in un output non è presente alcuna attività e non sono presenti consumer per VSync/VBlank, è disponibile una sola opzione: il sistema operativo deve mantenere VSync ON per l'output inattivo.

Per i dispositivi portatili a doppio schermo, mantenere VSync ON per uno schermo quando non è necessario ha costi di alimentazione significativi. Richiede che il collegamento display controller/display rimanga attivo e impedisce ai pannelli che supportano l'aggiornamento automatico in modalità a bassa frequenza e a basso consumo automatico. In Windows 10 versione 2004 e successive DxgkDdiControlInterrupt3 consente un controllo VSync di granularità più fine per ogni origine VidPn di un adattatore.

Solo uno dei DxgkDdiControlInterrupt3 o DxgkDdi_ControlInterrupt2 verrà usato dal sistema operativo durante la durata di un adattatore.

I driver WDDM 2.7 che non implementano DxgkDdi_ControlInterrupt3 rifiutano il controllo VSync VidPn indipendente e il sistema operativo chiamerà solo DxgkDdi_ControlInterrupt2. La funzionalità di DXGK_DRIVERCAPS->IndependentVidPnVSync deve essere 0 nei driver che non supportano DxgkDdi_ControlInterrupt3; in caso contrario, l'inizializzazione dell'adapter avrà esito negativo. Se un driver implementa DxgkDdi_ControlInterrupt3, la funzionalità può essere impostata su 0 o 1 per indicare Per-VidPn supporto.