struttura D3DKMT_ESCAPE (d3dkmthk.h)

Articolo
10/23/2024

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;

Membri

[in] hAdapter

Handle per la scheda grafica in cui vengono scambiate le informazioni.

[in] hDevice

Handle per un dispositivo di visualizzazione specificato facoltativamente se le informazioni da scambiare sono specifiche di un determinato dispositivo.

[in] Type

Valore di tipo D3DKMT_ESCAPETYPE che indica di scambiare informazioni con il driver miniport di visualizzazione o di controllare i componenti in modalità kernel. Nella tabella seguente vengono illustrati i valori possibili.

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. Solo a scopo di test. La progettazione immagine e configurazione OpenGL 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 della memoria video.
D3DKMT_ESCAPE_TDRDBGCTRL (2)	Non usare. Solo a scopo di test. 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. Solo a scopo di test. 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. Solo a scopo di test. La progettazione immagine e configurazione OpenGL 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. Solo a scopo di test. 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. Solo a scopo di test. Progettazione immagine e configurazione OpenGL 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. Solo a scopo di test. La progettazione immagine e configurazione openGL imposta lo stato di aggiornamento del driver miniport visualizzato.
D3DKMT_ESCAPE_DRT_TEST (8)	Non usare. Solo a scopo di test.
D3DKMT_ESCAPE_DIAGNOSTICS (9)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_BDD_PNP (12)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_BDD_FALLBACK (13)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_WQHL_INFO(16)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_BRIGHTNESS(17)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_EDID_CACHE(18)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	Non usare. Solo a scopo di test. Supportato a partire da Windows 8.1.

[in] Flags

Struttura D3DDDI_ESCAPEFLAGS che indica, in flag di campo di bit, come condividere informazioni. OpenGL ICD deve specificare l'HardwareAccess flag di campo di bit per indicare che il driver miniport di visualizzazione deve accedere all'hardware grafico in modo che il sistema operativo debba eseguire il secondo livello di sincronizzazione nel driver miniport di visualizzazione per la chiamata DxgkDdiEscape.

[in/out] pPrivateDriverData

Puntatore a un buffer allocato da Progettazione immagine e configurazione OpenGL che contiene informazioni che la progettazione immagine e configurazione OpenGL scambia con il driver miniport di visualizzazione 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	Specifico del driver. 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. Solo a scopo di test. Struttura D3DKMT_VIDMM_ESCAPE.
D3DKMT_ESCAPE_TDRDBGCTRL	Non usare. Solo a scopo di test. Tipo di enumerazione D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH	Non usare. Solo a scopo di test. Struttura D3DKMT_VIDSCH_ESCAPE.
D3DKMT_ESCAPE_DEVICE	Non usare. Solo a scopo di test. Struttura D3DKMT_DEVICE_ESCAPE.
D3DKMT_ESCAPE_DMM	Non usare. Solo a scopo di test. Struttura D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT	Non usare. Solo a scopo di test. Struttura D3DKMT_DEBUG_SNAPSHOT_ESCAPE.

[in] PrivateDriverDataSize

Dimensioni, in byte, del buffer a cui pPrivateDriverData punta. La progettazione immagine e configurazione OpenGL deve specificare le dimensioni del buffer quando chiama la funzione D3DKMTEscape .

[in] hContext

Handle per un contesto specificato facoltativamente se le informazioni da scambiare sono specifiche di un particolare contesto di dispositivo. Se la progettazione immagine e configurazione openGL imposta hContext su un valore non NULL, è necessario impostare anche hDevice su un valore non NULL e hDevice deve corrispondere al dispositivo proprietario del contesto.

Osservazioni

A scopo di test, la funzione 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 di Dxgkrnl.sys) e il comportamento del processo TDR del sistema operativo.