структура VIDEO_HW_INITIALIZATION_DATA (video.h)

Статья
02/07/2025

Структура VIDEO_HW_INITIALIZATION_DATA указывает точки входа и требования к хранилищу для мини-драйвера. Эта структура создается в стеке и инициализирована функцией драйвера miniport DriverEntry.

Синтаксис

typedef struct _VIDEO_HW_INITIALIZATION_DATA {
  ULONG                          HwInitDataSize;
  INTERFACE_TYPE                 AdapterInterfaceType;
  PVIDEO_HW_FIND_ADAPTER         HwFindAdapter;
  PVIDEO_HW_INITIALIZE           HwInitialize;
  PVIDEO_HW_INTERRUPT            HwInterrupt;
  PVIDEO_HW_START_IO             HwStartIO;
  ULONG                          HwDeviceExtensionSize;
  ULONG                          StartingDeviceNumber;
  PVIDEO_HW_RESET_HW             HwResetHw;
  PVIDEO_HW_TIMER                HwTimer;
  PVIDEO_HW_START_DMA            HwStartDma;
  PVIDEO_HW_POWER_SET            HwSetPowerState;
  PVIDEO_HW_POWER_GET            HwGetPowerState;
  PVIDEO_HW_GET_CHILD_DESCRIPTOR HwGetVideoChildDescriptor;
  PVIDEO_HW_QUERY_INTERFACE      HwQueryInterface;
  ULONG                          HwChildDeviceExtensionSize;
  PVIDEO_ACCESS_RANGE            HwLegacyResourceList;
  ULONG                          HwLegacyResourceCount;
  PVIDEO_HW_LEGACYRESOURCES      HwGetLegacyResources;
  BOOLEAN                        AllowEarlyEnumeration;
  ULONG                          Reserved;
} VIDEO_HW_INITIALIZATION_DATA, *PVIDEO_HW_INITIALIZATION_DATA;

Члены

HwInitDataSize

Размер в байтах этой структуры. В действительности это означает, что используется версия VIDEO_HW_INITIALIZATION_DATA.

AdapterInterfaceType

В настоящее время игнорируется порт видео и должен оставаться нулевой инициализацией.

HwFindAdapter

Указатель на функцию драйвера минипорта HwVidFindAdapter, которая необходима для всех драйверов минипорта.

HwInitialize

Указатель на функцию драйвера минипорта HwVidInitialize, которая требуется для всех драйверов минипорта.

HwInterrupt

Указатель на функцию драйвера минипорта HwVidInterrupt, которая требуется, только если адаптер минипорта создает прерывания. В противном случае этот указатель должен быть null.

HwStartIO

Указатель на функцию драйвера минипорта HwVidStartIO, которая необходима для всех драйверов минипорта.

HwDeviceExtensionSize

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

Указатель на расширение устройства передается при каждом вызове стандартных функций драйвера минипорта, кроме DriverEntry, HwVidSynchronizeExecutionCallbackи любых функций SvgaHwIoPortXxx. Драйвер видеопорта выделяет память для расширения устройства и инициализирует его с нулями перед передачей в функцию драйвера мини-порта HwVidFindAdapter.

StartingDeviceNumber

Должно быть задано равно нулю.

HwResetHw

Указатель на функцию драйвера минипорта HwVidResetHw, которая требуется для любого минипорт-драйвера адаптера, который не сбрасывает полностью на обратимой перезагрузке компьютера. Драйверы адаптеров SVGA, которые полностью сбрасываются в стандартный режим символов VGA при получении команды INT10, mode3-type обычно задает значение NULL.

HwTimer

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

HwStartDma

Зарезервировано для использования системы.

HwSetPowerState

Указатель на функцию драйвера минипорта HwVidSetPowerState, которая необходима для всех драйверов минипорта.

HwGetPowerState

Указатель на функцию драйвера минипорта HwVidGetPowerState, которая необходима для всех драйверов минипорта.

HwGetVideoChildDescriptor

Указатель на функцию драйвера минипорта HwVidGetVideoChildDescriptor, которая требуется для всех драйверов минипорта.

HwQueryInterface

Указатель на функцию драйвера мини-порта HwVidQueryInterface. Это можно при необходимости реализовать в мини-драйвере, поддерживающем внешние интерфейсы программирования для взаимодействия между устройствами, например, поддержку I2C (или IІC) для декодеров MPEG. В противном случае этот элемент должен иметь значение NULL.

HwChildDeviceExtensionSize

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

HwLegacyResourceList

Указатель на массив VIDEO_ACCESS_RANGE структур. Каждая структура описывает порт ввода-вывода устройства или диапазон памяти для видеоадаптера, который не указан в пространстве конфигурации PCI.

HwLegacyResourceCount

Число элементов в массиве, в котором точках HwLegacyResource List.

HwGetLegacyResources

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

AllowEarlyEnumeration

Позволяет минипорту перечислить дочерние устройства перед запуском адаптера; То есть драйвер видеопорта может вызывать HwVidGetVideoChildDescriptor, прежде чем HwVidFindAdapter, если для этого элемента задано значение TRUE .

Reserved

Зарезервировано для использования системы.

Замечания

Функция драйвера минипорта DriverEntry должна инициализировать эту структуру с нулями, прежде чем задать соответствующие значения в любом элементе.

Драйвер видеопорта игнорирует HwLegacyResourceCount и членов HwLegacyResourceList при инициализации HwGetLegacyResources указателем на реализацию HwVidLegacyResources.