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

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

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

Никакой

Замечания

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

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

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

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

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

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

Требования

См. также

VideoPortRegisterBugcheckCallback