PVIDEO_HW_INITIALIZE funzione di callback (video.h)

Articolo
08/07/2023

HwVidInitialize esegue la prima inizializzazione della scheda, dopo che hal ha rinunciato al controllo dell'hardware video al driver della porta video.

Sintassi

PVIDEO_HW_INITIALIZE PvideoHwInitialize;

BOOLEAN PvideoHwInitialize(
  PVOID HwDeviceExtension
)
{...}

Parametri

HwDeviceExtension

Puntatore all'area di archiviazione per scheda del driver miniport. Per altre informazioni, vedere Estensioni del dispositivo.

Valore restituito

Se l'inizializzazione ha esito positivo, HwVidInitialize restituisce TRUE.

Commenti

Ogni driver miniport video deve avere una funzione HwVidInitialize .

Il driver della porta video chiama HwVidInitialize in risposta a una richiesta aperta dal driver di visualizzazione corrispondente. Non appena viene chiamato HwVidInitialize , il driver miniport può modificare lo stato dell'adattatore, a differenza della funzione HwVidFindAdapter del driver miniport, che deve lasciare l'adattatore in modalità VGA. Al ritorno da HwVidInitialize, l'adattatore deve essere inizializzato in uno stato equivalente a quello impostato dalla funzione HwVidResetHw del driver miniport. Questa funzionalità viene usata dalla funzione automatica per ottenere informazioni sulla modalità dal driver miniport.

Se possibile, HwVidInitialize dovrebbe evitare di programmare l'hardware del dispositivo. Il driver miniport inizializzerà il dispositivo in un secondo momento, quando viene richiesto di cambiare modalità di visualizzazione.

HwVidInitialize deve essere reso impaginabile.