PVIDEO_HW_INITIALIZE Rückruffunktion (video.h)
HwVidInitialize führt die erste Initialisierung des Adapters durch, nachdem die HAL die Steuerung der Videohardware an den Videoporttreiber aufgegeben hat.
Syntax
PVIDEO_HW_INITIALIZE PvideoHwInitialize;
BOOLEAN PvideoHwInitialize(
PVOID HwDeviceExtension
)
{...}
Parameter
HwDeviceExtension
Zeigen Sie auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.
Rückgabewert
Wenn die Initialisierung erfolgreich ist, gibt HwVidInitializeTRUEzurück.
Bemerkungen
Jeder Video-Miniporttreiber muss über eine HwVidInitialize-Funktion verfügen.
Der Videoporttreiber ruft HwVidInitialize als Reaktion auf eine offene Anforderung des entsprechenden Anzeigetreibers auf. Sobald HwVidInitialize aufgerufen wird, kann der Miniporttreiber den Zustand des Adapters ändern, im Gegensatz zu der HwVidFindAdapter--Funktion des Miniporttreibers, die den Adapter im VGA-Modus verlassen muss. Im Gegenzug von HwVidInitializemuss der Adapter in einen Zustand initialisiert werden, der dem zustand entspricht, der vom HwVidResetHw Funktion des Miniporttreibers eingerichtet wurde. Dieses Feature wird von autodetection verwendet, um Modusinformationen vom Miniporttreiber abzurufen.
Wenn möglich, sollten HwVidInitialize die Programmierung der Gerätehardware vermeiden. Der Miniporttreiber initialisiert das Gerät später, wenn er angewiesen wird, anzeigemodi zu wechseln.
HwVidInitialize sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |