функция обратного вызова DXGKDDI_ESCAPE (d3dkmddi.h)

Статья
02/06/2025

Функция DxgkDdiEscape предоставляет общие сведения с драйвером отображения в пользовательском режиме.

Синтаксис

DXGKDDI_ESCAPE DxgkddiEscape;

NTSTATUS DxgkddiEscape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}

Параметры

[in] hAdapter

Дескриптор к блоку контекста, связанному с адаптером отображения. Драйвер минипорта отображения ранее предоставил этот дескриптор подсистеме ядра графики Microsoft DirectX в MiniportDeviceContext выходном параметре функции DxgkDdiAddDevice.

[in] pEscape

Указатель на структуру DXGKARG_ESCAPE, содержащую сведения о общей информации.

Примечание Для вызова DxgkDdiEscape на втором уровне должен быть установлен флаг HardwareAccess в структуре D3DDDI_ESCAPEFLAGS, являющейся членом DXGKARG_ESCAPE. Если этот флаг не задан, вызов завершится ошибкой.

Возвращаемое значение

DxgkDdiEscape возвращает одно из следующих значений:

Возвращаемый код	Описание
STATUS_SUCCESS	DxgkDdiEscape успешно поделился информацией.
STATUS_INVALID_PARAMETER	Параметры, переданные в DxgkDdiEscape, содержали ошибки, которые препятствовали завершению.
STATUS_NO_MEMORY	DxgkDdiEscape не удалось выделить память, необходимую для завершения.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape обнаружил непривилегированные инструкции (т. е. инструкции, которые получают доступ к памяти за пределами привилегий текущего центрального процесса обработки [ЦП]).
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape обнаружил инструкции, которые графическое оборудование не поддерживает.
STATUS_GRAPHICS_DRIVER_MISMATCH	Драйвер мини-порта дисплея несовместим с драйвером отображения в пользовательском режиме, который инициировал вызов DxgkDdiEscape.

Замечания

Подсистема ядра графики DirectX вызывает функцию драйвера минипорта дисплея DxgkDdiEscape, когда драйвер отображения в пользовательском режиме должен совместно использовать сведения с драйвером мини-порта дисплея таким образом, который не поддерживается через другие связи с драйверами.

DxgkDdiEscape должен быть создан на страницу.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также

DXGKARG_ESCAPE

DxgkDdiAddDevice

pfnEscapeCb

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