Funzione DrvEnableDriver (winddi.h)

Articolo
03/04/2024

La funzione DrvEnableDriver è il punto di ingresso del driver iniziale esportato dalla DLL del driver. Compila una struttura DRVENABLEDATA con il numero di versione DDI della grafica del driver e gli indirizzi chiamanti di tutte le funzioni DDI grafiche supportate dal driver.

Sintassi

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Parametri

iEngineVersion

Identifica la versione di GDI attualmente in esecuzione.

cj

Dimensione in byte della struttura a cui punta il pded. Se la struttura è maggiore del previsto, i membri aggiuntivi devono essere lasciati invariati.

[in] pded

Puntatore a una struttura DRVENABLEDATA . GDI zero-initialize cj bytes prima della chiamata. Il driver compila i propri dati.

Valore restituito

Il valore restituito è TRUE se il driver specificato è abilitato. In caso contrario, è FALSE e viene registrato un codice di errore.

Commenti

DrvEnableDriver deve essere implementato in tutti i driver grafici. Se usi gli strumenti di compilazione di Windows Driver Kit (WDK) e hai impostato TARGETTYPE su GDI_DRIVER (vedi Compilazione di una DLL grafica della stampante), questa funzione deve essere denominata DrvEnableDriver. Si tratta dell'unica funzione driver di visualizzazione a cui è necessario accedere in base al nome. Tutte le altre funzioni del driver di visualizzazione sono accessibili tramite puntatori a funzione; pertanto, i nomi vengono presentati in questa documentazione come pseudonome.

Le inizializzazioni una tantum, ad esempio l'allocazione di semafori, possono essere eseguite anche da questa funzione. Il driver deve attendere fino a quando drvEnablePDEV viene chiamato prima di abilitare l'hardware, ad esempio uno schermo.

Quando si esegue il controllo della versione usando il valore specificato in iEngineVersion, il driver deve usare la costante DDI_DRIVER_VERSION_Xxx appropriata (definita in winddi.h) illustrata nella tabella seguente. I driver non dovrebbero quasi mai verificare l'uguaglianza perché le nuove versioni e le versioni del Service Pack per il sistema operativo verranno rilasciate in futuro. Per altre informazioni, vedere DRVENABLEDATA.

Valore	Versione del sistema operativo
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1