Funzione D3DKMTEscape (d3dkmthk.h)
Il D3DKMTEscape funzione scambia informazioni tra il driver di visualizzazione in modalità utente (UMD) (o il driver client) e il driver miniport in modalità kernel (KMD).
Sintassi
NTSTATUS D3DKMTEscape(
[in] const D3DKMT_ESCAPE *unnamedParam1
);
Parametri
[in] unnamedParam1
Puntatore a una struttura D3DKMT_ESCAPE che descrive le informazioni scambiate.
Valore restituito
D3DKMTEscape restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Le informazioni sono state condivise 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 in modo che non siano corretti. |
| STATUS_NO_MEMORY | D3DKMTEscape non è stato possibile completare a causa di memoria insufficiente. |
| STATUS_PRIVILEGED_INSTRUCTION | D3DKMTEscape rilevato istruzioni senza privilegi (ovvero istruzioni che accedono alla memoria oltre il privilegio del processo cpu corrente). |
| STATUS_ILLEGAL_INSTRUCTION | D3DKMTEscape rilevate istruzioni che non possono essere supportate dall'hardware grafico. |
Questa funzione potrebbe restituire anche altri valori NTSTATUS.
Osservazioni
Il driver client o UMD chiama D3DKMTEscape per scambiare dati direttamente con il KMD. A scopo di test, D3DKMTEscape può essere chiamato per controllare la gestione della memoria video (VidMm) e l'utilità di pianificazione GPU (che fanno parte di Dxgkrnl.sys) e il comportamento del processo TDR (Timeout Detection and Recovery) del sistema operativo.
I fornitori di hardware possono usare D3DKMTEscape nei driver come meccanismo di estensione. Tuttavia, i fornitori devono segnalare le estensioni necessarie a Microsoft in modo che le estensioni possano essere supportate in modo nativo dal sistema operativo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Universale |
| intestazione | d3dkmthk.h (include D3dkmthk.h) |
| libreria | Gdi32.lib |
| dll | Gdi32.dll |