Funzione EngCreateDriverObj (winddi.h)
La funzione EngCreateDriverObj crea una struttura DRIVEROBJ .
Sintassi
ENGAPI HDRVOBJ EngCreateDriverObj(
PVOID pvObj,
FREEOBJPROC pFreeObjProc,
HDEV hdev
);
Parametri
pvObj
Puntatore alla risorsa driver che verrà tracciata dalla struttura DRIVEROBJ. La risorsa è associata al processo client corrente.
pFreeObjProc
Puntatore a una funzione di callback fornita dal driver che libera la risorsa puntata da pvObj. La funzione di callback deve essere definita come segue, dove pDriverObj punta alla struttura DRIVEROBJ:
BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);
hdev
Gestire il dispositivo fisico associato all'oggetto . Questo parametro è l'handle GDI ricevuto dalla funzione DrvCompletePDEV del driver.
Valore restituito
Il valore restituito è un handle che identifica la struttura DRIVEROBJ appena creata se la funzione ha esito positivo. In caso contrario, è zero.
Commenti
Questa struttura viene usata per tenere traccia di una risorsa gestita dal dispositivo che deve essere rilasciata se il processo di allocazione delle risorse termina senza prima pulirlo.
Il driver può eliminare in modo esplicito la struttura DRIVEROBJ chiamando EngDeleteDriverObj. In caso contrario, il motore libera la risorsa chiamando la funzione puntata da pFreeObjProc quando il processo che ha creato DRIVEROBJ termina.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |