DXGKARG_COMMITVIDPN_FLAGS struttura (d3dkmddi.h)

La struttura DXGKARG_COMMITVIDPN_FLAGS identifica i dettagli relativi a una chiamata alla funzione DxgkDdiCommitVidPn .

Sintassi

typedef struct _DXGKARG_COMMITVIDPN_FLAGS {
  UINT PathPowerTransition : 1;
  UINT PathPoweredOff : 1;
  UINT Reserved : 30;
} DXGKARG_COMMITVIDPN_FLAGS;

Members

PathPowerTransition

Valore UINT che specifica se il sottosistema del kernel della grafica Microsoft DirectX chiama la funzione DxgkDdiCommitVidPn per disattivare un monitoraggio connesso.

Se PathPowerTransition è impostato su TRUE, il driver miniport visualizzato può ottimizzare questa chiamata per un risparmio di energia (ad esempio, il driver potrebbe disabilitare le sincronizzazioni verticali). Il driver deve essere consapevole anche che potrebbe comunque ricevere chiamate alla funzione DxgkDdiPresent nell'origine interessata.

L'impostazione di questo membro equivale a impostare il primo bit di un valore a 32 bit (0x00000001).

Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

PathPoweredOff

Valore UINT che specifica se il sottosistema del kernel della grafica DirectX chiama DxgkDdiCommitVidPn per informare il driver che l'utente ha modificato le modalità.

Se PathPoweredOff è impostato su TRUE, il driver miniport visualizzato deve prevedere operazioni presenti basate sulla nuova topologia. Il driver non può eseguire alcuna operazione che causerebbe l'attivazione del percorso della topologia(ad esempio, il driver non può abilitare le sincronizzazioni verticali) perché il monitoraggio dovrebbe essere disattivato.

Se PathPoweredOff è impostato su FALSE, il percorso della topologia è attivato. Il driver miniport visualizzato deve programmare l'hardware per le operazioni presenti basate sul percorso precedente della topologia e il driver deve eseguire il commit dell'hardware per supportare questo percorso di topologia. L'impostazione di questo membro equivale a impostare il secondo bit di un valore a 32 bit (0x00000002).

Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Reserved

Questo membro è riservato e deve essere impostato su zero. L'impostazione di questo membro su zero equivale a impostare i 30 bit rimanenti (0xFFFFFFFC) di un valore a 32 bit su zero.

Commenti

La struttura DXGKARG_COMMITVIDPN_FLAGS archivia informazioni che il driver miniport visualizzato può usare per determinare come rispondere alle modifiche della modalità richieste. Con queste informazioni, il driver può distinguere tra le modifiche della modalità che si verificano durante l'attività regolare perché un'applicazione ha richiesto una modifica della modalità, le modifiche che si verificano a causa delle transizioni di alimentazione e le modifiche che si verificano mentre i monitor vengono disattivati.

Durante l'attività regolare, quando viene chiamata la funzione DxgkDdiCommitVidPn , i membri PathPowerTransition e PathPoweredOff saranno FALSE in modo che il driver debba applicare immediatamente le modifiche alla modalità. Tali modifiche in modalità vengono in genere eseguite come eventi isolati. Pertanto, non è necessario che il driver tiene traccia di qualsiasi stato associato alla configurazione della modalità precedente.

Se i monitor vengono disattivati o attivati, PathPowerTransition sarà TRUE per indicare una transizione di alimentazione. In questo caso, un modello comune è che i monitor verranno disattivati e quindi in un secondo momento, la configurazione originale verrà ripristinata. Può essere un carico di lavoro significativo per il driver per reimpostare completamente la configurazione di visualizzazione dopo l'arresto del sistema. Inoltre, il driver deve continuare a completare le operazioni DxgkDdiPresent mentre i monitor vengono disattivati. Tuttavia, il driver può ridurre il carico di lavoro quando viene effettuata una chiamata a DxgkDdiCommitVidPn assicurandosi che i monitor coinvolti siano disattivati. Quando viene ripristinata l'alimentazione, il carico di lavoro del driver per ripristinare la configurazione di visualizzazione verrà quindi ridotto.

Poiché il monitoraggio potrebbe non essere connesso fisicamente (al momento della ripresa del sistema, ad esempio), il driver non deve basarsi su Windows per eseguire una chiamata successiva alla funzione DxgkDdiSetPowerState per impostare lo stato di alimentazione del dispositivo figlio della scheda di visualizzazione. Tuttavia, Windows richiederà comunque che il CRTC sia attivato. Se il driver non attiva la sincronizzazione verticale quando viene richiesto di farlo tramite gestione modalità di visualizzazione (DMM) e se l'utente successivamente riconnette il monitoraggio, la visualizzazione del monitor potrebbe essere vuota.

Le operazioni DxgkDdiPresent devono comunque essere rispettate dal driver mentre i monitor vengono disattivati. Il driver potrebbe dover agire su una modifica della modalità attivata da un'applicazione, ad esempio per eseguire modifiche alla pipeline di rendering per tenere conto delle modifiche di rotazione. Le impostazioni di PathPowerTransition = FALSE e PathPoweredOff = TRUE informano il driver che si è verificata una modifica di tale modalità. In questo caso, il driver non deve attivare i monitor, ma deve invece riprogrammare l'hardware, se necessario, per supportare la modifica della modalità in modo che sia possibile completare operazioni DxgkDdiPresent aggiuntive. Quando tale modifica della modalità è stata eseguita e i monitoraggi vengono riattivati in seguito, è improbabile che la modalità che si è verificata prima del ripristino dell'alimentazione.

Se un'operazione di ripresa del sistema viene attivata dopo la disattivazione dei monitoraggi per un'operazione di sospensione del sistema, il driver può ricevere una chiamata DxgkDdiCommitVidPn con PathPowerTransitionFALSE e PathPoweredOff = FALSE prima che venga eseguita una chiamata DxgkDdiCommitVidPn con PathPowerTransition = = TRUE. Questa situazione deve verificarsi solo con una topologia vuota e, in questo caso, il driver non deve riattivare i monitor perché la transizione di alimentazione non è ancora stata completata.

Requisiti

Vedi anche

DXGKARG_COMMITVIDPN

DxgkDdiPresent

DxgkDdiSetPowerState