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


Функция 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

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

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

Никакой

Замечания

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
целевая платформа Настольный
заголовка video.h (include Video.h)
библиотеки Videoprt.lib
DLL Videoprt.sys
IRQL <= DIRQL

См. также

VideoDebugPrint