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

Статья
02/06/2025

Очищает внутренние ресурсы, связанные с пакетом прямого доступа к памяти (DMA), который был в очереди программного обеспечения планировщика GPU, но никогда не достиг очереди оборудования, так как устройство попало в состояние ошибки. Такое состояние ошибки обычно вызвано событием обнаружения времени ожидания и восстановления (TDR).

Синтаксис

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

Параметры

hAdapter

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

pCancelCommand

Указатель на структуру DXGKARG_CANCELCOMMAND, указывающую ресурсы для очистки после удаления команды из очереди оборудования.

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

Возвращает STATUS_SUCCESS после успешного завершения. Если драйвер возвращает код ошибки, операционная система вызывает ошибку системы. Дополнительные сведения см. в следующем разделе "Примечания".

Замечания

примечание подсистема ядра графики DirectX вызывает эту функцию, только если DXGK_VIDSCHCAPS.задан элемент CancelCommandAware.

Если драйвер возвращает код ошибки, подсистема ядра графики DirectX вызывает ошибку системы. В файле аварийного дампа ошибка отмечается сообщением BugCheck 0x119, которое имеет следующие четыре параметра.

0x9
Код ошибки NTSTATUS, возвращенный из вызова драйвера сбоем
Указатель на структуру DXGKARG_CANCELCOMMAND
Указатель на внутреннюю структуру данных планировщика

Требования

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

См. также

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice

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