VIDEO_HW_INITIALIZATION_DATA Struktur (video.h)

Artikel
02/07/2025

Die VIDEO_HW_INITIALIZATION_DATA Struktur gibt die Einstiegspunkte und Speicheranforderungen für den Miniporttreiber an. Diese Struktur wird auf dem Stapel erstellt und von der DriverEntry-Funktion des Miniporttreibers initialisiert.

Syntax

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;

Angehörige

HwInitDataSize

Ist die Größe in Byte dieser Struktur. Dies gibt die verwendete Version von VIDEO_HW_INITIALIZATION_DATA an.

AdapterInterfaceType

Wird derzeit vom Videoport ignoriert und sollte null initialisiert bleiben.

HwFindAdapter

Zeiger auf die HwVidFindAdapter--Funktion des Miniporttreibers, die für alle Miniporttreiber erforderlich ist.

HwInitialize

Zeiger auf die HwVidInitialize-Funktion des Miniporttreibers, die für alle Miniporttreiber erforderlich ist.

HwInterrupt

Zeiger auf die HwVidInterrupt--Funktion des Miniporttreibers, die nur erforderlich ist, wenn der Adapter des Miniporttreibers Unterbrechungen generiert. Andernfalls muss dieser Zeiger NULL-sein.

HwStartIO

Zeiger auf die HwVidStartIO-Funktion des Miniporttreibers, die für alle Miniporttreiber erforderlich ist.

HwDeviceExtensionSize

Gibt die Größe in Byte des Speichers an, den der Miniporttreiber für seine private, adapterspezifische Geräteerweiterung benötigt. Ein Miniporttreiber verwendet diesen Speicher, um treiberbestimmte Informationen pro Adapter zu speichern, z. B. die zugeordneten logischen Adressbereiche für die Adapterregister und alle Kontextinformationen, die der Treiber über seine E/A-Vorgänge verwaltet.

Ein Zeiger auf die Geräteerweiterung wird in jedem Aufruf der Standardfunktionen des Miniporttreibers übergeben, außer DriverEntry, HwVidSynchronizeExecutionCallback-und alle SvgaHwIoPortXxx Funktionen. Der Videoporttreiber weist den Speicher für die Geräteerweiterung zu und initialisiert ihn mit Nullen, bevor er an die HwVidFindAdapter--Funktion des Miniporttreibers übergeben wird.

StartingDeviceNumber

Muss auf Null festgelegt werden.

HwResetHw

Zeiger auf die HwVidResetHw--Funktion des Miniporttreibers, der für jeden Miniporttreiber eines Adapters erforderlich ist, der nicht vollständig auf einem soften Neustart des Computers zurückgesetzt wird. Treiber von SVGA-Adaptern, die vollständig auf einen VGA-Standardzeichenmodus zurückgesetzt werden, wenn ein INT10-Befehl vom Typ MODE3 angezeigt wird, legen sie in der Regel auf NULL-fest.

HwTimer

Zeiger auf die HwVidTimer--Funktion eines Miniporttreibers, die optional ist. Dieser Zeiger kann NULL-sein.

HwStartDma

Reserviert für die Systemverwendung.

HwSetPowerState

Zeiger auf die HwVidSetPowerState-Funktion des Miniporttreibers, die für alle Miniporttreiber erforderlich ist.

HwGetPowerState

Zeiger auf die HwVidGetPowerState- Funktion des Miniporttreibers, die für alle Miniporttreiber erforderlich ist.

HwGetVideoChildDescriptor

Zeiger auf die HwVidGetVideoChildDescriptor Funktion des Miniporttreibers, die für alle Miniporttreiber erforderlich ist.

HwQueryInterface

Zeiger auf die HwVidQueryInterface--Funktion des Miniporttreibers. Dies kann optional in einem Miniporttreiber implementiert werden, der externe Programmierschnittstellen für die geräteübergreifende Kommunikation unterstützt, z. B. I2C- (oder I²C)-Unterstützung für MPEG-Decoder. Andernfalls sollte dieses Element auf NULL-festgelegt werden.

HwChildDeviceExtensionSize

Ist die Größe in Byte der Geräteerweiterung, die dem Anzeigeausgabegerät zugeordnet ist. Der Miniporttreiber sollte dieses Mitglied nur ausfüllen, wenn der Miniporttreiber die Monitorkonfigurationsdaten getrennt von der Adapterboardkonfiguration verwalten muss.

HwLegacyResourceList

Zeigen Sie auf ein Array von VIDEO_ACCESS_RANGE Strukturen. Jede Struktur beschreibt einen Geräte-E/A-Anschluss oder Speicherbereich für den Grafikkarten, der nicht im PCI-Konfigurationsraum aufgeführt ist.

HwLegacyResourceCount

Ist die Anzahl der Elemente im Array, auf die HwLegacyResourceList Punkte.

HwGetLegacyResources

Zeiger auf die HwVidLegacyResources-Funktion des Miniporttreibers, wodurch der Treiber seine Legacyressourcen basierend auf seinen Geräte- und Hersteller-IDs angeben kann.

AllowEarlyEnumeration

Ermöglicht es dem Miniporttreiber, seine untergeordneten Geräte auflisten, bevor der Adapter gestartet wird. d. h. der Videoporttreiber kann HwVidGetVideoChildDescriptor- aufrufen, bevor HwVidFindAdapter, wenn dieses Element auf "TRUE"festgelegt ist.

Reserved

Reserviert für die Systemverwendung.

Bemerkungen

Die DriverEntry-Funktion eines Miniporttreibers muss diese Struktur mit Nullen initialisieren, bevor relevante Werte in einem beliebigen Element festgelegt werden.

Der Videoporttreiber ignoriert die HwLegacyResourceCount und HwLegacyResourceList Member, wenn HwGetLegacyResources- mit einem Zeiger auf eine HwVidLegacyResources Implementierung initialisiert wird.