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

Vedi anche

DRIVEROBJ

EngDeleteDriverObj