Funzione D3DKMTSetDisplayMode (d3dkmthk.h)
La funzione D3DKMTSetDisplayMode imposta l'allocazione usata per eseguire l'analisi sullo schermo.
Sintassi
NTSTATUS D3DKMTSetDisplayMode(
[in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);
Parametri
[in, out] unnamedParam1
Puntatore a una struttura D3DKMT_SETDISPLAYMODE che descrive l'allocazione utilizzata per eseguire l'analisi.
Valore restituito
D3DKMTSetDisplayMode restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | La modalità di visualizzazione è stata impostata correttamente. |
| STATUS_DEVICE_REMOVED | La scheda grafica è stata arrestata o il dispositivo di visualizzazione è stato reimpostato. |
| STATUS_INVALID_PARAMETER | I parametri sono stati convalidati e sono stati determinati come non corretti. |
| STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER | Prima della chiamata a D3DKMTSetDisplayMode, il dispositivo non acquisì la proprietà esclusiva della visualizzazione. Pertanto, il dispositivo non è riuscito a impostare la modalità di visualizzazione. |
| D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | Il driver client installabile OpenGL deve convertire il formato della superficie associata all'allocazione specificata dal membro hPrimaryAllocation di D3DKMT_SETDISPLAYMODE nell'attributo di formato specificato dal membro PrivateDriverFormatAttribute di D3DKMT_SETDISPLAYMODE . La progettazione immagine e configurazione deve quindi chiamare di nuovo D3DKMTSetDisplayMode . Progettazione immagine e configurazione di Windows potrebbe allocare una nuova allocazione, eseguire un trasferimento bit-block di conversione (bitblt) dal database primario precedente al nuovo e quindi eliminare definitivamente il database primario precedente, purché la progettazione immagine e configurazione usi il nuovo handle di allocazione per questa allocazione per tutte le operazioni successive. La configurazione immagine e configurazione deve ripetere questo processo fino a quando D3DKMTSetDisplayMode restituisce un valore restituito diverso. |
Questa funzione potrebbe anche restituire altri valori NTSTATUS .
Commenti
Prima che OpenGL ICD chiami D3DKMTSetDisplayMode per impostare una nuova modalità di visualizzazione che usa un formato esteso, un metodo di campionamento multiplo o entrambi, la progettazione immagine e configurazione deve garantire che la modalità di visualizzazione GDI corrente abbia la stessa risoluzione della nuova modalità di visualizzazione. In caso contrario, D3DKMTSetDisplayMode restituisceSTATUS_INVALID_PARAMETER.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Universale |
| Intestazione | d3dkmthk.h (include D3dkmthk.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |