Функция IddCxReportCriticalError (iddcx.h)

  • Статья

IddCxReportCriticalError — это функция обратного вызова ОС, вызываемая косвенным драйвером отображения (IDD), чтобы сообщить о критической ошибке.

Синтаксис

NTSTATUS IddCxReportCriticalError(
  IDDCX_ADAPTER                      AdapterObject,
  const IDARG_IN_REPORTCRITICALERROR *pInArgs
);

Параметры

AdapterObject

Объект IDDCX_ADAPTER адаптера, в котором произошла критическая ошибка. Если ошибка произошла до создания IDDCX_ADAPTER, идентификатор idD должен передать nullptr.

pInArgs

Указатель на структуру IDARG_IN_REPORTCRITICALERROR , содержащую код ошибки критической ошибки.

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

Если подпрограмма завершается успешно, она никогда не вернется к драйверу, так как процесс драйвера будет завершен.

Комментарии

Когда IDD вызывает IddCxCxCriticalError, ОПЕРАЦИОННая система выполняет следующие действия:

  • Проверка ошибок в драйвере с помощью следующего кода проверки ошибок: (pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode. Рекомендуется, чтобы драйвер использовал уникальное сочетание основного и дополнительного кода, чтобы эти случаи можно было определить в отчетах о сбоях и Watson.
  • Завершите процесс драйвера и перезапустите его в соответствии с политикой перезапуска драйвера UMDF.
  • Если вызывающий объект является удаленным идентификатором idD, отключите сеанс пользователя.

При создании дампа памяти в пользовательском режиме драйвер должен поместить все полезные отладочные сведения в стек функции с именем IddCxCxCriticalError.

Требования

Требование Значение
Минимальная версия клиента Windows 10
Верхняя часть iddcx.h

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

IDARG_IN_REPORTCRITICALERROR