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

Статья
08/07/2023

Очищает внутренние ресурсы, связанные с пакетом прямого доступа к памяти (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 вызывает проверку системных ошибок. В файле аварийного дампа ошибка отмечается сообщением BugCheck 0x119, которое имеет следующие четыре параметра.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также раздел

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice

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