функция обратного вызова 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 .
Возвращаемое значение
None
Remarks
Эта функция доступна в Windows XP с пакетом обновления 1 (SP1) и более поздних версий.
Эта функция вызывается при возникновении ошибки проверка. Драйвер мини-порта может собирать данные, которые должны быть добавлены в файл дампа, и записывать эти данные в буфер. Драйвер не должен записывать в буфер больше байтов BufferSize .
Драйвер видео минипорта регистрирует функцию HwVidBugcheckCallback , вызывая функцию VideoPortRegisterBugcheckCallback . Функция VideoPortRegisterBugcheckCallback предоставляет системе этот обратный вызов драйвера минипорта для видео.
Чтобы упростить восстановление системы после проверка ошибок, все регистры, к которым обращается эта функция, не должны препятствовать переходу оборудования в резервный режим независимо от состояния устройства. Кроме того, функция должна возвращать управление вызывающей объекту.
Так как система может состоять из нескольких драйверов видео минипорта, поставщики должны добавить идентифицирующие строки к данным, которые эта функция добавляет в файл дампа.
Функция вызывается при вызове IRQL и не должна пытаться получить доступ к страничним коду или данным.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | video.h (включить Video.h) |