Поделиться через


структура D3DKMT_ESCAPE (d3dkmthk.h)

Структура D3DKMT_ESCAPE описывает сведения, обменивающиеся с драйвером мини-порта дисплея.

Синтаксис

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;

Члены

[in] hAdapter

Дескриптор графического адаптера, на который обмениваются сведениями.

[in] hDevice

Дескриптор отображаемого устройства, который при необходимости указывается, если данные, которые необходимо обменять, относятся к конкретному устройству.

[in] Type

Значение типа D3DKMT_ESCAPETYPE, указывающее либо обмен данными с драйвером мини-порта дисплея, либо для управления компонентами режима ядра. В следующей таблице показаны возможные значения.

значение значение
D3DKMT_ESCAPE_DRIVERPRIVATE (0) Элемент pPrivateDriverData предназначен для драйвера мини-порта дисплея. Поставщик оборудования определяет формат escape-данных.
D3DKMT_ESCAPE_VIDMM (1) Не используйте. Только для тестирования. OpenGL ICD управляет диспетчером памяти видео (который является частью Dxgkrnl.sys). Буфер, на который указывает pPrivateDriverData, содержит D3DKMT_VIDMM_ESCAPE структуру, которая поддерживает различные типы управления диспетчером памяти видео.
D3DKMT_ESCAPE_TDRDBGCTRL (2) Не используйте. Только для тестирования. Операция escape позволяет пользователю управлять поведением процесса обнаружения и восстановления операционной системы .
Эта функция отключена по умолчанию. Чтобы включить эту функцию, значение реестра TdrTestMode = TdrTestMode DWORD, хранящееся в разделе HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers, должно иметь значение 1.
Для члена PrivateDriverDataSize задано значение sizeof(int). Элемент pPrivateDriverData имеет целое число со значением из типа перечисления D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH (3) Не используйте. Только для тестирования. OpenGL ICD управляет планировщиком графической обработки (GPU), который входит в состав Dxgkrnl.sys). Буфер, на который указывает pPrivateDriverData, содержит структуру D3DKMT_VIDSCH_ESCAPE, которая поддерживает управление предварительной очисткой и приостановку или возобновление планировщика.
D3DKMT_ESCAPE_DEVICE (4) Не используйте. Только для тестирования. OpenGL ICD управляет устройством отображения. Буфер, на который указывает pPrivateDriverData, содержит структуру D3DKMT_DEVICE_ESCAPE, которая поддерживает получение источника видео из основного выделения.
D3DKMT_ESCAPE_DMM (5) Не используйте. Только для тестирования. OpenGL ICD управляет диспетчером режима отображения. Буфер, на который указывает pPrivateDriverData, содержит D3DKMT_DMM_ESCAPE структуру.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6) Не используйте. Только для тестирования. OpenGL ICD извлекает буфер моментального снимка отладки. Буфер, на который указывает pPrivateDriverData, содержит структуру D3DKMT_DEBUG_SNAPSHOT_ESCAPE.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7) Не используйте. Только для тестирования. OpenGL ICD задает состояние обновления драйвера мини-порта отображения.
D3DKMT_ESCAPE_DRT_TEST (8) Не используйте. Только для тестирования.
D3DKMT_ESCAPE_DIAGNOSTICS (9) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_BDD_PNP (12) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_BDD_FALLBACK (13) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_WQHL_INFO(16) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_BRIGHTNESS(17) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_EDID_CACHE(18) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028) Не используйте. Только для тестирования. Поддерживается начиная с Windows 8.1.

[in] Flags

Структура D3DDDI_ESCAPEFLAGS, показывающая, как предоставлять доступ к данным в битовых полях. OpenGL ICD должен указать флаг HardwareAccess битовое поле, чтобы указать, что драйвер мини-порта отображения должен получить доступ к графическому оборудованию таким образом, чтобы операционная система должна выполнять второй уровень синхронизации в драйвер минипорта дисплея для вызова DxgkDdiEscape.

[in/out] pPrivateDriverData

Указатель на буфер, выделенный OpenGL ICD, содержащий сведения, которые OpenGL ICD обменивается с мини-драйвером отображения или используется для управления компонентами режима ядра. В следующей таблице описывается содержимое буфера, на который pPrivateDriverData указывает значение Type.

значение элемента типа Содержимое буфера pPrivateDriverData
D3DKMT_ESCAPE_DRIVERPRIVATE Для конкретного драйвера. Буфер недоступен, если не существует жесткой связи между OpenGL ICD и драйвером минипорта дисплея.
D3DKMT_ESCAPE_VIDMM Не используйте. Только для тестирования. Структура D3DKMT_VIDMM_ESCAPE.
D3DKMT_ESCAPE_TDRDBGCTRL Не используйте. Только для тестирования. Тип перечисления D3DKMT_TDRDBGCTRLTYPE.
D3DKMT_ESCAPE_VIDSCH Не используйте. Только для тестирования. Структура D3DKMT_VIDSCH_ESCAPE.
D3DKMT_ESCAPE_DEVICE Не используйте. Только для тестирования. Структура D3DKMT_DEVICE_ESCAPE.
D3DKMT_ESCAPE_DMM Не используйте. Только для тестирования. Структура D3DKMT_DMM_ESCAPE.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT Не используйте. Только для тестирования. Структура D3DKMT_DEBUG_SNAPSHOT_ESCAPE.

[in] PrivateDriverDataSize

Размер буфера в байтах, на который pPrivateDriverData. OpenGL ICD должен указать размер буфера при вызове функции D3DKMTEscape.

[in] hContext

Дескриптор контекста, который при необходимости указывается, если данные для обмена зависят от определенного контекста устройства. Если openGL ICD задает hContext значение, отличное от NULL, ICD должен также задать hDevice значением, не допускающим значение NULL, и hDevice должны соответствовать устройству, которому принадлежит контекст.

Замечания

В целях тестирования openGL ICD может передать указатель на структуру D3DKMT_ESCAPE в вызове функции D3DKMEscape для управления диспетчером памяти видео и планировщиком GPU (которые являются частью Dxgkrnl.sys) и поведением процесса TDR операционной системы.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista
заголовка d3dkmthk.h (include D3dkmthk.h)

См. также

D3DKMEscape

D3DKMT_DEBUG_SNAPSHOT_ESCAPE

D3DKMT_DEVICE_ESCAPE

D3DKMT_DMM_ESCAPE

D3DKMT_TDRDBGCTRLTYPE

D3DKMT_VIDMM_ESCAPE

D3DKMT_VIDSCH_ESCAPE