Metodo IWiaMiniDrv::d rvFreeDrvItemContext (wiamindr_lh.h)
Il metodo IWiaMiniDrv::d rvFreeDrvItemContext libera un contesto specifico del dispositivo.
Sintassi
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Parametri
__MIDL__IWiaMiniDrv0056
lFlags [in]
Riservato.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Punta a un contesto specifico del dispositivo.
__MIDL__IWiaMiniDrv0058
plDevErrVal [out]
Punta a una posizione di memoria che riceverà un codice di stato per questo metodo. Se questo metodo restituisce S_OK, il valore archiviato sarà zero. In caso contrario, un codice di errore specifico del minidriver verrà archiviato nella posizione a cui punta questo parametro.
Valore restituito
In caso di esito positivo, il metodo deve restituire S_OK e cancellare il valore di errore del dispositivo a cui punta plDevErrVal. Se il metodo ha esito negativo, deve restituire un codice di errore COM standard e inserire un codice di errore specifico del minidriver nella memoria a cui punta plDevErrVal.
Il valore a cui punta plDevErrVal può essere convertito in una stringa chiamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Commenti
Quando un elemento del driver viene eliminato, il servizio WIA libera il contesto dell'elemento del driver. Questo metodo informa il minidriver che il contesto è pronto per essere liberato. Il minidriver deve liberare qualsiasi memoria allocata per il contesto. Ad esempio, in IWiaMiniDrv::d rvReadItemProperties, un minidriver della fotocamera potrebbe allocare una cache per archiviare l'anteprima di un elemento e archiviare un puntatore a questa cache nel contesto dell'elemento driver. Il minidriver libera quindi la cache in questo metodo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (include Wiamindr.h) |