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

Статья
05/26/2023

Функция 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