Método IWiaMiniDrv::d rvFreeDrvItemContext (wiamindr_lh.h)
O método IWiaMiniDrv::d rvFreeDrvItemContext libera um contexto específico do dispositivo.
Sintaxe
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Parâmetros
__MIDL__IWiaMiniDrv0056
lFlags [in]
Reservado.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Aponta para um contexto específico do dispositivo.
__MIDL__IWiaMiniDrv0058
plDevErrVal [out]
Aponta para um local de memória que receberá um código status para esse método. Se esse método retornar S_OK, o valor armazenado será zero. Caso contrário, um código de erro específico do minidriver será armazenado no local apontado por esse parâmetro.
Retornar valor
Em caso de êxito, o método deve retornar S_OK e limpar o valor de erro do dispositivo apontado por plDevErrVal. Se o método falhar, ele deverá retornar um código de erro COM padrão e colocar um código de erro específico do minidriver na memória apontada por plDevErrVal.
O valor apontado por plDevErrVal pode ser convertido em uma cadeia de caracteres chamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Comentários
Quando um item de driver é excluído, o serviço WIA libera o contexto do item de driver. Esse método informa ao minidriver que o contexto está pronto para ser liberado. O minidriver deve liberar qualquer memória alocada para o contexto. Por exemplo, em IWiaMiniDrv::d rvReadItemProperties, um minidriver de câmera pode alocar um cache para armazenar a miniatura de um item e armazenar um ponteiro para esse cache no contexto do item de driver. O minidriver liberaria o cache nesse método.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |