VideoPortInitialize-Funktion (video.h)
Die VideoPortInitialize-Funktion führt einen Teil der Miniporttreiberinitialisierung aus, wobei Systemressourcen für den Miniporttreiber zugewiesen 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 of Video Miniport Driver aufgerufen hat.
Argument2
Ein zweiter Zeiger, mit dem das Betriebssystem DriverEntry aufgerufen hat.
HwInitializationData
Zeiger auf die VIDEO_HW_INITIALIZATION_DATA Struktur auf dem Stapel. Die DriverEntry-Routine des Miniporttreibers hat diese Struktur null initialisiert und dann mit treiberspezifischen Konfigurationsinformationen ausgefüllt, die einen Videoadapter beschreiben, den der Miniporttreiber unterstützen kann.
HwContext
Muss NULL sein.
Rückgabewert
VideoPortInitialize gibt den letzten status des Initialisierungsvorgangs zurück.
Hinweise
Jeder Videominiporttreiber muss VideoPortInitialize über seine DriverEntry-Funktion aufrufen. DriverEntry kann VideoPortInitialize erst aufrufen, nachdem es zuerst null initialisiert und dann die VIDEO_HW_INITIALIZATION_DATA-Struktur eingerichtet hat. VideoPortInitialize kann nur über die DriverEntry-Funktion eines Miniporttreibers aufgerufen werden.
Die VideoPortInitialize-Funktion :
- Überprüft die Gültigkeit der VIDEO_HW_INITIALIZATION_DATA Spezifikationen des Miniporttreibers.
- Ordnet Arbeitsspeicher für zu, und initialisiert null eine VIDEO_PORT_CONFIG_INFO-Struktur .
- Füllt in VIDEO_PORT_CONFIG_INFO so viele Adapterkonfigurationsinformationen wie möglich aus.
- Füllt einige der öffentlichen Member des vom System erstellten Geräteobjekts ein, um die Grafikkarte darzustellen. Der Videoporttreiber verwaltet die Geräteobjekte, daher muss sich der Miniporttreiber nicht um Geräteobjektdetails kümmern.
- Ordnet Arbeitsspeicher für das Geräteobjekt zu und initialisiert die Geräteerweiterung von null. Eine Geräteerweiterung ist der primäre und einzige globale Speicherbereich jedes Miniporttreibers für adapterspezifische Zustandsinformationen. Der Miniporttreiber gibt die Größe der Geräteerweiterung im HwDeviceExtensionSize-Member von VIDEO_HW_INITIALIZATION_DATA an. Der Videoporttreiber übergibt diese Geräteerweiterung an die meisten von ihr aufgerufenen Miniporttreiberfunktionen.
- Erfasst und speichert relevante Informationen in der Geräteerweiterung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | video.h (einschließen von Video.h) |
| Bibliothek | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |