PVIDEO_HW_INITIALIZE Rückruffunktion (video.h)
HwVidInitialize führt die erste Initialisierung des Adapters durch, nachdem die HAL die Kontrolle über die Videohardware an den Videoporttreiber aufgegeben hat.
Syntax
PVIDEO_HW_INITIALIZE PvideoHwInitialize;
BOOLEAN PvideoHwInitialize(
PVOID HwDeviceExtension
)
{...}
Parameter
HwDeviceExtension
Zeiger auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.
Rückgabewert
Wenn die Initialisierung erfolgreich ist, gibt HwVidInitializeTRUE zurück.
Hinweise
Jeder Videominiporttreiber 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 Status des Adapters ändern, im Gegensatz zur HwVidFindAdapter-Funktion des Miniporttreibers, die den Adapter im VGA-Modus belassen muss. Bei der Rückkehr von HwVidInitialize muss der Adapter in einen Zustand initialisiert werden, der dem von der HwVidResetHw-Funktion des Miniporttreibers entspricht. Dieses Feature wird von der automatischen Erkennung verwendet, um Modusinformationen vom Miniporttreiber abzurufen.
Wenn möglich, sollte HwVidInitialize die Programmierung der Gerätehardware vermeiden. Der Miniporttreiber initialisiert das Gerät später, wenn es angewiesen wird, die Anzeigemodi zu wechseln.
HwVidInitialize sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | video.h (einschließen von Video.h) |