Método IWiaMiniDrv::d rvFreeDrvItemContext (wiamindr_lh.h)
El método IWiaMiniDrv::d rvFreeDrvItemContext libera un contexto específico del dispositivo.
Sintaxis
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Parámetros
__MIDL__IWiaMiniDrv0056
lFlags [in]
Reservado.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Apunta a un contexto específico del dispositivo.
__MIDL__IWiaMiniDrv0058
plDevErrVal [out]
Apunta a una ubicación de memoria que recibirá un código de estado para este método. Si este método devuelve S_OK, el valor almacenado será cero. De lo contrario, se almacenará un código de error específico del minidriver en la ubicación a la que apunta este parámetro.
Valor devuelto
Si se ejecuta correctamente, el método debe devolver S_OK y borrar el valor de error del dispositivo al que apunta plDevErrVal. Si se produce un error en el método, debe devolver un código de error COM estándar y colocar un código de error específico del minidriver en la memoria a la que apunta plDevErrVal.
El valor al que apunta plDevErrVal se puede convertir en una cadena llamando a IWiaMiniDrv::d rvGetDeviceErrorStr.
Observaciones
Cuando se elimina un elemento de controlador, el servicio WIA libera el contexto del elemento de controlador. Este método informa al minidriver de que el contexto está listo para liberarse. El minidriver debe liberar cualquier memoria que haya asignado para el contexto. Por ejemplo, en IWiaMiniDrv::d rvReadItemProperties, un minidriver de cámara podría asignar una memoria caché para almacenar la miniatura de un elemento y almacenar un puntero a esta memoria caché en el contexto del elemento de controlador. A continuación, el minidriver liberaría la memoria caché en este método.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamindr_lh.h (incluya Wiamindr.h) |