Функция VideoPortLogError (video.h)

Функция VideoPortLogError регистрирует ошибки в журнале системных событий, когда драйвер мини-порта обнаруживает состояние ошибки оборудования во время операций ввода-вывода.

Синтаксис

VIDEOPORT_API VOID VideoPortLogError(
  PVOID                 HwDeviceExtension,
  PVIDEO_REQUEST_PACKET Vrp,
  VP_STATUS             ErrorCode,
  ULONG                 UniqueId
);

Параметры

HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

Vrp

[необязательно] Указатель на структуру [VIDEO_REQUEST_PACKET], которая описывает пакет видео-запроса (VRP), если он связан с ошибкой; в противном случае — NULL.

ErrorCode

Указывает код ошибки, определяемый драйвером мини-порта, который указывает тип ошибки оборудования.

UniqueId

Указывает уникальный идентификатор ошибки. Это значение отличает текущую ошибку от других ошибок с тем же кодом ошибки. Для некоторых драйверов мини-портов это определяет строку кода, в которой была обнаружена ошибка; Для других — это значение, возвращаемое оборудованием.

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

None

Remarks

Драйверы miniport должны вызывать VideoPortLogError , чтобы уведомить пользователя, если драйвер сталкивается с необычными аппаратными ошибками во время обычной работы. Публикация таких ошибок в журнале системных событий предупреждает пользователя о том, что видеоадаптер может завершиться сбоем, чтобы пользователь мог заменить (или перенастроить) адаптер до полного сбоя оборудования.

Однако драйверы мини-портов не должны регистрировать ошибки, такие как "не удалось обнаружить оборудование", которые часто возникают во время обычной работы.

VideoPortLogError можно вызвать из функции HwVidInterrupt или HwVidSynchronizeExecutionCallback драйвера мини-порта.

Требования

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

VideoDebugPrint