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

Статья
02/07/2025

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

Синтаксис

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

Параметры

Argument1

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

Argument2

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

HwInitializationData

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

HwContext

Должен быть null.

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

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

Замечания

Каждый драйвер минипорта видео должен вызывать VideoPortInitialize из функции DriverEntry. DriverEntry может вызывать VideoPortInitialize только после первого нулевого инициализации, а затем настройки структуры VIDEO_HW_INITIALIZATION_DATA. VideoPortInitialize можно вызывать только из функции драйвера miniport 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 (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL