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

Статья
02/29/2024

Функция VideoPortInitialize выполняет часть инициализации драйвера мини-порта, выделяя системные ресурсы для драйвера мини-порта.

Синтаксис

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

Параметры

Argument1

Указатель, с помощью которого операционная система называется DriverEntry of Video Miniport Driver.

Argument2

Второй указатель, с помощью которого операционная система называется DriverEntry.

HwInitializationData

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

HwContext

Должно иметь значение NULL.

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

VideoPortInitialize возвращает окончательное состояние операции инициализации.

Каждый драйвер видео минипорта должен вызывать VideoPortInitialize из функции DriverEntry . DriverEntry может вызывать VideoPortInitialize только после инициализации с нуля, а затем настройки структуры VIDEO_HW_INITIALIZATION_DATA . VideoPortInitialize можно вызывать только из функции DriverEntry драйвера мини-порта.

Функция VideoPortInitialize :

Проверяет допустимость спецификаций VIDEO_HW_INITIALIZATION_DATA драйвера минипорта.
Выделяет память для структуры VIDEO_PORT_CONFIG_INFO и инициализирует ее с нуля.
Заполняет как можно больше сведений о конфигурации адаптера в VIDEO_PORT_CONFIG_INFO.
Заполняет некоторые открытые элементы объекта устройства, созданного системой для представления графического адаптера. Драйвер видеопорта управляет объектами устройства, поэтому драйверу мини-порта не нужно беспокоиться об объекте устройства.
Выделяет память для объекта устройства и ноль инициализирует расширение устройства. Расширение устройства — это основное и только глобальное хранилище каждого драйвера минипорта для сведений о состоянии адаптера. Драйвер мини-порта указывает размер расширения устройства в элементе HwDeviceExtensionSize VIDEO_HW_INITIALIZATION_DATA. Драйвер видеопорта передает это расширение устройства большинству функций драйвера минипорта, которые он вызывает.
Собирает и сохраняет соответствующую информацию в расширении устройства.

Подпрограмма DriverEntry драйвера мини-порта передает значение, возвращенное VideoPortInitialize , обратно вызывающей стороне. Драйверы мини-порта не должны использовать это возвращаемое значение.

Требования

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