struttura D3DKMT_ESCAPE (d3dkmthk.h)
La struttura D3DKMT_ESCAPE descrive le informazioni scambiate con il driver miniport di visualizzazione.
Sintassi
typedef struct _D3DKMT_ESCAPE {
[in] D3DKMT_HANDLE hAdapter;
[in] D3DKMT_HANDLE hDevice;
[in] D3DKMT_ESCAPETYPE Type;
[in] D3DDDI_ESCAPEFLAGS Flags;
[in/out] VOID *pPrivateDriverData;
[in] UINT PrivateDriverDataSize;
[in] D3DKMT_HANDLE hContext;
} D3DKMT_ESCAPE;
Members
[in] hAdapter
Handle per la scheda grafica su cui vengono scambiate le informazioni.
[in] hDevice
Handle per un dispositivo di visualizzazione specificato facoltativamente se le informazioni da scambiare sono specifiche di un dispositivo specifico.
[in] Type
Valore di tipo D3DKMT_ESCAPETYPE che indica se scambiare informazioni con il driver miniport di visualizzazione o per controllare i componenti in modalità kernel. Nella tabella seguente sono illustrati i possibili valori.
Valore | Significato |
---|---|
D3DKMT_ESCAPE_DRIVERPRIVATE (0) | Il membro pPrivateDriverData è destinato al driver miniport di visualizzazione. Il fornitore dell'hardware definisce il formato dei dati di escape. |
D3DKMT_ESCAPE_VIDMM (1) | Non usare. For testing purposes only. OpenGL ICD controlla la gestione della memoria video ,che fa parte di Dxgkrnl.sys. Il buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_VIDMM_ESCAPE che supporta vari tipi di controllo della gestione memoria video. |
D3DKMT_ESCAPE_TDRDBGCTRL (2) | Non usare. For testing purposes only. L'operazione di escape consente all'utente di controllare il comportamento del processo TDR (Timeout Detection and Recovery) del sistema operativo. Questa funzionalità è disabilitata per impostazione predefinita. Per abilitare questa funzionalità, il valore del Registro di sistema TdrTestMode = TdrTestMode DWORD, archiviato nella chiave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers, deve essere impostato su 1. Il membro PrivateDriverDataSize è impostato su sizeof(int). Il membro pPrivateDriverData è impostato su un numero intero con un valore del tipo di enumerazione D3DKMT_TDRDBGCTRLTYPE. |
D3DKMT_ESCAPE_VIDSCH (3) | Non usare. For testing purposes only. OpenGL ICD controlla l'utilità di pianificazione dell'unità di elaborazione grafica (GPU), che fa parte di Dxgkrnl.sys. Il buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_VIDSCH_ESCAPE che supporta il controllo di precedenza e la sospensione o la ripresa dell'utilità di pianificazione. |
D3DKMT_ESCAPE_DEVICE (4) | Non usare. For testing purposes only. OpenGL ICD controlla il dispositivo di visualizzazione. Il buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_DEVICE_ESCAPE che supporta l'acquisizione dell'origine video presente dall'allocazione primaria. |
D3DKMT_ESCAPE_DMM (5) | Non usare. For testing purposes only. La progettazione immagine e configurazione OpenGL controlla la gestione della modalità di visualizzazione. Buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_DMM_ESCAPE . |
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6) | Non usare. For testing purposes only. OpenGL ICD recupera un buffer di snapshot di debug. Buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_DEBUG_SNAPSHOT_ESCAPE . |
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7) | Non usare. For testing purposes only. La progettazione immagine e configurazione OpenGL imposta lo stato di aggiornamento del driver miniport di visualizzazione. |
D3DKMT_ESCAPE_DRT_TEST (8) | Non usare. For testing purposes only. |
D3DKMT_ESCAPE_DIAGNOSTICS (9) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_BDD_PNP (12) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_BDD_FALLBACK (13) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_WQHL_INFO(16) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_BRIGHTNESS(17) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_EDID_CACHE(18) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20) | Non usare. For testing purposes only. Supportato a partire da Windows 8.1. |
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21) | Non usare. For testing purposes only. Supportato a partire da Windows 8.1. |
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23) | Non usare. For testing purposes only. Supportato a partire da Windows 8.1. |
D3DKMT_ESCAPE_WIN32K_START(1024) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025) | Non usare. For testing purposes only. Supportato a partire da Windows 8. |
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026) | Non usare. For testing purposes only. Supportato a partire da Windows 8.1. |
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027) | Non usare. For testing purposes only. Supportato a partire da Windows 8.1. |
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028) | Non usare. For testing purposes only. Supportato a partire da Windows 8.1. |
[in] Flags
Struttura D3DDDI_ESCAPEFLAGS che indica, in flag di campo a bit, come condividere le informazioni. L'ICD OpenGL deve specificare il flag di campo a bit HardwareAccess per indicare che il driver miniport visualizzato deve accedere all'hardware grafico in modo che il sistema operativo debba eseguire il secondo livello di sincronizzazione nel driver miniport visualizzato per la chiamata DxgkDdiEscape .
[in/out] pPrivateDriverData
Puntatore a un buffer allocato dall'ICD OpenGL che contiene informazioni che l'ICD OpenGL scambia con il driver miniport visualizzato o usa per controllare i componenti in modalità kernel. Nella tabella seguente viene descritto il contenuto del buffer a cui pPrivateDriverData punta, a seconda del valore di Type.
Valore del membro Type | Contenuto del buffer pPrivateDriverData |
---|---|
D3DKMT_ESCAPE_DRIVERPRIVATE | Driver specifico. Il buffer non è utilizzabile a meno che non esista un accoppiamento stretto tra openGL ICD e il driver miniport di visualizzazione. |
D3DKMT_ESCAPE_VIDMM | Non usare. For testing purposes only. Struttura D3DKMT_VIDMM_ESCAPE . |
D3DKMT_ESCAPE_TDRDBGCTRL | Non usare. For testing purposes only. Tipo di enumerazione D3DKMT_TDRDBGCTRLTYPE. |
D3DKMT_ESCAPE_VIDSCH | Non usare. For testing purposes only. Struttura D3DKMT_VIDSCH_ESCAPE . |
D3DKMT_ESCAPE_DEVICE | Non usare. For testing purposes only. Struttura D3DKMT_DEVICE_ESCAPE . |
D3DKMT_ESCAPE_DMM | Non usare. For testing purposes only. Struttura D3DKMT_DMM_ESCAPE . |
D3DKMT_ESCAPE_DEBUG_SNAPSHOT | Non usare. For testing purposes only. Struttura D3DKMT_DEBUG_SNAPSHOT_ESCAPE . |
[in] PrivateDriverDataSize
Dimensioni, in byte, del buffer a cui pPrivateDriverData punta. L'ICD OpenGL deve specificare le dimensioni del buffer quando chiama la funzione D3DKMTEscape .
[in] hContext
Un handle a un contesto specificato facoltativamente se le informazioni da scambiare sono specifiche di un determinato contesto del dispositivo. Se l'ICD OpenGL imposta hContext su un valore non NULL, il codice ICD deve avere anche impostato hDevice su un valore non NULL e hDevice deve corrispondere al dispositivo proprietario del contesto.
Commenti
A scopo di test, l'ICD OpenGL può passare un puntatore a una struttura D3DKMT_ESCAPE in una chiamata alla funzione D3DKMTEscape per controllare la gestione della memoria video e l'utilità di pianificazione GPU (che fanno parte diDxgkrnl.sys) e il comportamento del processo TDR del sistema operativo.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Intestazione | d3dkmthk.h (include D3dkmthk.h) |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere:Invia e visualizza il feedback per