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

Статья
08/08/2023

Структура VIDEO_HW_INITIALIZATION_DATA определяет точки входа и требования к хранилищу для драйвера мини-порта. Эта структура создается в стеке и инициализируется функцией 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, обычно устанавливают для этого параметра значение NULL.

HwTimer

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

HwStartDma

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

HwSetPowerState

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

HwGetPowerState

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

HwGetVideoChildDescriptor

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

HwQueryInterface

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

HwChildDeviceExtensionSize

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

HwLegacyResourceList

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

HwLegacyResourceCount

Количество элементов в массиве, на которые указывает HwLegacyResourceList .

HwGetLegacyResources

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

AllowEarlyEnumeration

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

Reserved

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