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

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

  • Статья

Очищает внутренние ресурсы, связанные с пакетом прямого доступа к памяти (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, которое имеет следующие четыре параметра.
  1. 0x9
  2. Код ошибки NTSTATUS, возвращенный при сбое вызова драйвера
  3. Указатель на структуру DXGKARG_CANCELCOMMAND
  4. Указатель на структуру данных внутреннего планировщика

Требования

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

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

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice