Condividi tramite


D3DKMT_ESCAPE struttura (d3dkmthk.h)

La struttura D3DKMT_ESCAPE descrive le informazioni scambiate con il driver miniport visualizzato.

Sintassi

typedef struct _D3DKMT_ESCAPE {
  [in]     D3DKMT_HANDLE      hAdapter;
  [in]     D3DKMT_HANDLE      hDevice;
  [in]     D3DKMT_ESCAPETYPE  Type;
  [in]     D3DDDI_ESCAPEFLAGS Flags;
  void               D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  [in]     UINT               PrivateDriverDataSize;
  [in]     D3DKMT_HANDLE      hContext;
} D3DKMT_ESCAPE;

Members

[in] hAdapter

Handle per l'adattatore grafico che le informazioni vengono scambiate.

[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 visualizzato 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 visualizzato. 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 memoria video (che fa parte di Dxgkrnl.sys). 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 di rilevamento timeout e ripristino 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 intero con un valore dal 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. Buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_VIDSCH_ESCAPE che supporta il controllo di preemption 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. 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. OpenGL ICD controlla la gestione 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 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. L'ICD OpenGL imposta lo stato di aggiornamento del driver miniport visualizzato.
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 .

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

[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