Функция D3DKMTEscape (d3dkmthk.h)
Функция D3DKMTEscape обменивается информацией между драйвером отображения пользовательского режима (UMD) (или драйвером клиента) и драйвером мини-порта в режиме ядра (KMD).
Синтаксис
NTSTATUS D3DKMTEscape(
[in] const D3DKMT_ESCAPE *unnamedParam1
);
Параметры
[in] unnamedParam1
Указатель на структуру D3DKMT_ESCAPE, описывающую обмен данными.
Возвращаемое значение
D3DKMTEscape возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Информация была успешно предоставлена. |
| STATUS_DEVICE_REMOVED | Графический адаптер был остановлен или устройство отображения было сброшено. |
| STATUS_INVALID_PARAMETER | Параметры были проверены и определены как неверные. |
| STATUS_NO_MEMORY | D3DKMTEscape не удалось завершить из-за нехватки памяти. |
| STATUS_PRIVILEGED_INSTRUCTION | D3DKMTEscape обнаружили не привилегированные инструкции (т. е. инструкции, которые получают доступ к памяти за пределами привилегий текущего процесса ЦП). |
| STATUS_ILLEGAL_INSTRUCTION | D3DKMTEscape обнаружили инструкции, которые не поддерживаются графическим оборудованием. |
Эта функция также может возвращать другие значения NTSTATUS.
Замечания
UMD или драйвер клиента вызывает D3DKMTEscape для обмена данными напрямую с KMD. Для тестирования D3DKMEscape можно вызывать для управления диспетчером памяти видео (VidMm) и планировщиком GPU (которые являются частью Dxgkrnl.sys) и поведением процесса обнаружения и восстановления операционной системы (TDR).
Поставщики оборудования могут использовать D3DKMEscape в своих драйверах в качестве механизма расширения. Однако поставщики должны сообщать о необходимых расширениях корпорации Майкрософт, чтобы расширения могли поддерживаться операционной системой в собственном коде.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Всеобщий |
| заголовка | d3dkmthk.h (include D3dkmthk.h) |
| библиотеки | Gdi32.lib |
| DLL | Gdi32.dll |