struttura D3DKMT_ESCAPE (d3dkmthk.h)

Articolo
02/08/2025

La struttura D3DKMT_ESCAPE descrive le informazioni scambiate tra un driver di visualizzazione in modalità utente (UMD) (o driver client) e il driver miniport (KMD) in modalità kernel.

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 enumerazione D3DKMT_ESCAPETYPE che indica di scambiare informazioni con il KMD 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 KMD. Il fornitore dell'hardware definisce il formato dei dati di escape.
D3DKMT_ESCAPE_VIDMM (1)	Non usare; solo a scopo di test. Il driver UMD/client controlla la gestione della memoria video (VidMm). Il buffer che pPrivateDriverData punta a contiene una struttura D3DKMT_VIDMM_ESCAPE che supporta vari tipi di controllo di VidMm.
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 intero con un valore del tipo di enumerazione D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH (3)	Non usare; solo a scopo di test. Il driver UMD/client controlla l'utilità di pianificazione GPU (che fa parte di Dxgkrnl). 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. Il driver UMD/client 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. Il driver UMD/client 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. Il driver UMD/client recupera un buffer 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. Il driver UMD/client imposta lo stato di aggiornamento kmD.
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 le informazioni. Il driver UMD/client deve specificare il flag HardwareAccess campo di bit per indicare che il kmD deve accedere all'hardware grafico in modo che il sistema operativo debba eseguire il secondo livello di sincronizzazione nel KMD per la chiamataDxgkDdiEscape.

HardwareAccess deve essere impostato su zero quando viene usata la virtualizzazione. Per altre informazioni, vedere paravirtualization GPU.

[in/out] pPrivateDriverData

Puntatore a un buffer allocato dal driver client o UMD che contiene una struttura di escape del driver nota. Questa struttura contiene informazioni che il driver scambia con il KMD 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 di tipo	Contenuto del buffer pPrivateDriverData
D3DKMT_ESCAPE_DRIVERPRIVATE	Specifico del driver. Il buffer non è utilizzabile a meno che non esista un accoppiamento stretto tra il driver UMD/client e il KMD.
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. Il driver UMD/client deve specificare le dimensioni del buffer quando chiama la funzioneD3DKMTEscape.

[in] hContext

Handle per un contesto specificato facoltativamente se le informazioni da scambiare sono specifiche di un particolare contesto di dispositivo. Se il driver UMD/client imposta hContext su un valore non NULL, il driver deve avere impostato anche hDevice su un valore non NULL e hDevice deve corrispondere al dispositivo proprietario del contesto.