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

Статья
02/07/2025

HwVidResetHw сбрасывает адаптер в режим символов.

Синтаксис

PVIDEO_HW_RESET_HW PvideoHwResetHw;

BOOLEAN PvideoHwResetHw(
  PVOID HwDeviceExtension,
  ULONG Columns,
  ULONG Rows
)
{...}

Параметры

HwDeviceExtension

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

Columns

Указывает количество столбцов настраиваемого режима.

Rows

Указывает количество строк настраиваемого режима.

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

HwVidResetHw должен возвращать TRUE, если адаптер полностью сбрасывается в заданный режим символов. В противном случае он должен вернуть FALSE, чтобы указать, что HAL должен выполнять эквивалент вызова BIOS ТИПА INT10, MODE3 типа BIOS после HwVidResetHw возвращает элемент управления.

Замечания

Драйвер видеопорта должен иметь функцию HwVidResetHw, если его адаптер не может быть сброшен в полностью инициализированное состояние без жесткой загрузки компьютера. Например, если код инициализации РОМ адаптера не может сбросить состояние адаптера в режим загрузки, драйвер мини-порта должен иметь функцию HwVidResetHw. Другая причина, по которой минипорт-драйвер должен реализовать эту функцию, заключается в том, чтобы очистить линии прерываний адаптера при отключении адаптера, тем самым избегая перебоя прерываний при следующей загрузке системы.

Hal вызывает HwVidResetHw, если система завершится сбоем, чтобы hal может отображать информацию на экране во время завершения работы системы. Этот вызов может возникать в любом IRQL, и драйвер должен быть готов к его обработке в любое время. Hal также вызывает HwVidResetHw непосредственно перед перезагрузкой компьютера при выполнении обратимой загрузки.

Большинство драйверов минипорта должны предоставлять эту функцию, за исключением драйверов адаптеров, которые сбрасываются в стандартный режим символов VGA при получении команды INT10, MODE3-type.

HwVidResetHw сбрасывает адаптер в режим символов в соответствии с заданными значениями столбцов и строк. Однако, так как система завершает работу, HwVidResetHw не может вызывать BIOS или любой код, доступный для страниц. HwVidResetHw должен вызывать только функции VideoPortRead/WritePortXxx и (или) VideoPortRead/WriteRegisterXxx. (См. функции, экспортированные драйвером видеопорта.)

Если HwVidResetHw не удается изменить режим адаптера путем простого программирования регистров адаптера, он может настроить соответствующие значения в регистрах адаптеров и вернуть FALSE. Это приводит к тому, что HAL выполняет расширенную операцию типа INT10, чтобы сбросить видеоадаптер в режим символов.

HwVidResetHw не должен вызывать VideoPortInt10. Функция драйвера мини-порта HwVidStartIO вызывается с помощью IOCTL_VIDEO_RESET_DEVICE VRP для сброса адаптера при использовании программы отображения для тестирования или изменения режима отображения графики не функции драйвера минипорта HwVidResetHw.

HwVidResetHw не должны быть доступны для страниц.