Функция VideoPortRegisterBugcheckCallback (video.h)

Статья
08/08/2023

Функция VideoPortRegisterBugcheckCallback позволяет драйверу видео минипорта зарегистрировать или перехватить обратный вызов, который вызывается при возникновении указанного проверка ошибок.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

[in] BugcheckCode

Указывает код проверка ошибки, для которого требуется обратный вызов. В настоящее время драйвер минипорта может регистрироваться только для проверка кода ошибок 0xEA.

[in] Callback

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

[in] BugcheckDataSize

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

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

VideoPortRegisterBugcheckCallback возвращает NO_ERROR в случае успешного выполнения. В противном случае возвращается код состояния, указывающий характер сбоя.

Если вы разрабатываете драйвер видео минипорта, предназначенный для работы в Windows XP или более ранней операционной системе NT-base, можно использовать процедуру обратного вызова VideoPortGetProcAddress , чтобы найти адрес функции VideoPortRegisterBugcheckCallback . Дополнительные сведения см. в разделе Использование VideoPortGetProcAddress.

Драйвер мини-порта может зарегистрироваться для обратного вызова при возникновении определенного типа ошибки проверка. В настоящее время можно подключить только 0xEA кода проверка ошибок. При возникновении проверка ошибок вызывается функция обратного вызова, предоставляемая мини-накопителем, и драйвер мини-порта может добавлять данные в файл дампа. Это полезно для сбора статистических данных, если прямая отладка невозможна.

Значение параметра BugcheckDataSize должно быть BUGCHECK_DATA_SIZE_RESERVED байт больше данных, предоставленных драйвером мини-порта. Например, предположим, что драйвер miniport предоставляет DUMP_SIZE байт данных для записи в файл дампа. Затем значение BugcheckDataSize должно быть DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED, а общее значение должно быть меньше или равно 4000.

Константная BUGCHECK_DATA_SIZE_RESERVED (определенная в video.h) доступна в средах сборки Microsoft Windows Server 2003 и более поздних версий. В среде сборки Windows XP с пакетом обновления 1 (SP1) вместо BUGCHECK_DATA_SIZE_RESERVED используйте 48.

Драйвер мини-порта может отменить регистрацию ранее зарегистрированного обратного вызова, вызвав эту функцию, указав ЗНАЧЕНИЕ NULL для параметра Callback или ноль для параметра DataSize .

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows XP с пакетом обновления 1 (SP1) и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	video.h (включить Video.h)
Библиотека	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

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

HwVidBugcheckCallback

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