VideoPortInitialize-Funktion (video.h)

Artikel
02/07/2025

Die VideoPortInitialize Funktion führt einen Teil der Miniporttreiberinitialisierung aus, wobei Systemressourcen für den Miniporttreiber zugeordnet werden.

Syntax

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

Parameter

Argument1

Ein Zeiger, mit dem das Betriebssystem DriverEntry des Video Miniport Driveraufgerufen wird.

Argument2

Ein zweiter Zeiger, mit dem das Betriebssystem DriverEntryaufgerufen hat.

HwInitializationData

Zeigen Sie auf die VIDEO_HW_INITIALIZATION_DATA Struktur im Stapel. Der DriverEntry des Miniporttreibers routinefreie Initialisierung dieser Struktur und füllte sie dann mit treiberspezifischen Konfigurationsinformationen ein, die einen Videoadapter beschreiben, den der Miniporttreiber unterstützen kann.

HwContext

Muss NULL-sein.

Rückgabewert

VideoPortInitialize den endgültigen Status des Initialisierungsvorgangs zurück.

Bemerkungen

Jeder Video-Miniporttreiber muss VideoPortInitialize- aus seiner DriverEntry--Funktion aufrufen. DriverEntry- kann VideoPortInitialize- erst aufrufen, nachdem sie zuerst null initialisiert und dann die VIDEO_HW_INITIALIZATION_DATA Struktur eingerichtet hat. VideoPortInitialize- kann nur von der DriverEntry--Funktion eines Miniporttreibers aufgerufen werden.

Die VideoPortInitialize Funktion:

Überprüft die Gültigkeit der VIDEO_HW_INITIALIZATION_DATA Spezifikationen des Miniporttreibers.
Ordnet Speicher für eine VIDEO_PORT_CONFIG_INFO-Struktur zu und initialisiert sie null.
Füllt so viele Adapterkonfigurationsinformationen wie in VIDEO_PORT_CONFIG_INFO aus.
Füllt einige der öffentlichen Member des vom System erstellten Geräteobjekts aus, um den Grafikadapter darzustellen. Der Videoporttreiber verwaltet die Geräteobjekte, daher muss der Miniporttreiber nicht mit Geräteobjektdetails in Verbindung stehen.
Weist Speicher für die Geräteerweiterung des Geräteobjekts zu und initialisiert die Geräteerweiterung. Eine Geräteerweiterung ist der primäre und nur globale Speicherbereich jedes Miniporttreibers für adapterspezifische Zustandsinformationen. Der Miniporttreiber gibt die Größe der Geräteerweiterung in der HwDeviceExtensionSize Member von VIDEO_HW_INITIALIZATION_DATA an. Der Videoporttreiber übergibt diese Geräteerweiterung an die meisten von ihr aufgerufenen Miniporttreiberfunktionen.
Sammelt und speichert relevante Informationen in der Geräteerweiterung.

Die DriverEntry Routine des Miniporttreibers gibt den von VideoPortInitialize zurück an den Aufrufer zurückgegebenen Wert weiter. Miniport-Treiber sollten diesen Rückgabewert nicht verwenden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	PASSIVE_LEVEL