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