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

D3DKMTEscape

D3DKMT_DEBUG_SNAPSHOT_ESCAPE

D3DKMT_DEVICE_ESCAPE

D3DKMT_DMM_ESCAPE

D3DKMT_TDRDBGCTRLTYPE

D3DKMT_VIDMM_ESCAPE

D3DKMT_VIDSCH_ESCAPE