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

Статья
08/07/2023

HwVidStartIO обрабатывает указанный VRP.

Синтаксис

PVIDEO_HW_START_IO PvideoHwStartIo;

BOOLEAN PvideoHwStartIo(
  PVOID HwDeviceExtension,
  PVIDEO_REQUEST_PACKET RequestPacket
)
{...}

Параметры

HwDeviceExtension

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

RequestPacket

Указатель на структуру VIDEO_REQUEST_PACKET , которая содержит все параметры, изначально переданные в EngDeviceIoControl.

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

HwVidStartIO должен возвращать значение TRUE, указывающее, что запрос выполнен.

Драйвер видеопорта вызывает HwVidStartIO в ответ на каждый запрос GDI EngDeviceIoControl , который исходит от соответствующего драйвера дисплея. При вызове HwVidStartIO драйвер мини-порта владеет пакетом входных видеозапросов, пока не завершит запрошенную операцию. HwVidStartIO должен выполнять следующие действия:

Просмотрите элемент IoControlCodeVRP , чтобы определить операцию, запрашиваемую драйвером отображения.
Убедитесь, что VRP InputBufferLength и (или) OutputBufferLength указывают буфер, достаточно большой для удовлетворения запроса. Драйвер мини-порта должен возвращать ошибку, если буфер слишком мал.
Удовлетворить запрос.
Задайте элементы Status и Information в VRP и верните значение TRUE.

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

Однако функция HwVidStartIO каждого драйвера минипорта должна завершить каждую запрошенную операцию или задать соответствующую ошибку в StatusBlock VRP, прежде чем она вернет управление.

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