DXGKDDI_CONTROLINTERRUPT3 funzione di callback (d3dkmddi.h)

Articolo
08/07/2023

La funzione DxgkDdi_ControlInterrupt3 abilita o disabilita il tipo di interruzione 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 interruzione, lo stato VSYNC e VidPnSourceId.

Valore restituito

DxgkDdi_ControlInterrupt3 restituisce uno dei valori seguenti:

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

Commenti

Il controllo VSync viene usato in WDDM per attivare 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 il 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, ovvero per una determinata scheda, il controllo VSync si applica a ogni origine VidPn della scheda. Si consideri ad esempio un adattatore con due origini VidPn connesse a due output diversi. Se un output non ha attività e nessun consumer per VSync/VBlank su di esso, c'è solo un'opzione: il sistema operativo deve mantenere VSync ON per l'output inattivo.

Per i dispositivi portatili a doppio schermo, mantenere VSync ON per una schermata quando non è necessario avere costi di potenza significativi. È necessario che il collegamento display controller/display rimanga attivo e impedisce ai pannelli di supportare l'aggiornamento automatico in una modalità di aggiornamento automatico a bassa frequenza e bassa potenza. In Windows 10 versione 2004 e versioni successive, DxgkDdiControlInterrupt3 consente il controllo VSync granularità più fine di per ogni origine VidPn di una scheda.

Solo uno di 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 VidPn VSync indipendente e il sistema operativo chiamerà solo DxgkDdi_ControlInterrupt2. La funzionalità DXGK_DRIVERCAPS-IndependentVidVSync> deve essere 0 nei driver che non supportano DxgkDdi_ControlInterrupt3; in caso contrario, l'inizializzazione della scheda del sistema operativo avrà esito negativo. Se un driver implementa DxgkDdi_ControlInterrupt3, la funzionalità può essere impostata su 0 o 1 per indicare Per-VidPn supporto.