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

Статья
03/01/2024

Функция HwVidBugcheckCallback позволяет драйверу мини-порта добавлять данные в файл дампа при возникновении проверка ошибок.

Синтаксис

PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;

void PvideoBugcheckCallback(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG BugcheckCode,
  [in] IN PUCHAR Buffer,
  [in] IN ULONG BufferSize
)
{...}

Параметры

[in] HwDeviceExtension

Указатель на область хранения для каждого адаптера драйвера мини-порта. Дополнительные сведения см. в разделе Расширения устройств.

[in] BugcheckCode

Указывает код проверка ошибки.

[in] Buffer

Указатель на расположение памяти, в котором драйвер мини-порта может хранить данные, которые должны быть добавлены в файл дампа.

[in] BufferSize

Задает размер (в байтах) буфера, на который указывает параметр Buffer .

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

None

Remarks

Эта функция доступна в Windows XP с пакетом обновления 1 (SP1) и более поздних версий.

Эта функция вызывается при возникновении ошибки проверка. Драйвер мини-порта может собирать данные, которые должны быть добавлены в файл дампа, и записывать эти данные в буфер. Драйвер не должен записывать в буфер больше байтов BufferSize .

Драйвер видео минипорта регистрирует функцию HwVidBugcheckCallback , вызывая функцию VideoPortRegisterBugcheckCallback . Функция VideoPortRegisterBugcheckCallback предоставляет системе этот обратный вызов драйвера минипорта для видео.

Чтобы упростить восстановление системы после проверка ошибок, все регистры, к которым обращается эта функция, не должны препятствовать переходу оборудования в резервный режим независимо от состояния устройства. Кроме того, функция должна возвращать управление вызывающей объекту.

Так как система может состоять из нескольких драйверов видео минипорта, venders должны добавить идентифицирующие строки к данным, которые эта функция добавляет в файл дампа.

Функция вызывается при вызове IRQL и не должна пытаться получить доступ к страничним коду или данным.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	video.h (включить Video.h)

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

VideoPortRegisterBugcheckCallback