Метод IWiaMiniDrv::d rvFreeDrvItemContext (wiamindr_lh.h)
Метод IWiaMiniDrv::d rvFreeDrvItemContext освобождает контекст для конкретного устройства.
Синтаксис
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Параметры
__MIDL__IWiaMiniDrv0056
lFlags [in]
Скрытный.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Указывает на контекст для конкретного устройства.
__MIDL__IWiaMiniDrv0058
plDevErrVal [out]
Указывает на расположение памяти, которое получит код состояния для этого метода. Если этот метод возвращает S_OK, сохраненное значение будет равно нулю. В противном случае код ошибки для мини-driver будет храниться в расположении, на которое указывает этот параметр.
Возвращаемое значение
При успешном выполнении метод должен возвращать S_OK и очищать значение ошибки устройства, указываемое на plDevErrVal. Если метод завершается ошибкой, он должен вернуть стандартный код ошибки COM и поместить в память код ошибки для мини-driver, на который указывает plDevErrVal.
Значение, указываемое plDevErrVal, можно преобразовать в строку путем вызова IWiaMiniDrv::d rvGetDeviceErrorStr.
Замечания
При удалении элемента драйвера служба WIA освобождает контекст элемента драйвера. Этот метод сообщает мини-driver, что контекст готов к освобождению. Мини-driver должен освободить любую память, выделенную для контекста. Например, в IWiaMiniDrv::d rvReadItemProperties, мини-driver камеры может выделить кэш для хранения эскиза элемента и сохранить указатель на этот кэш в контексте элемента драйвера. Затем мини-driver освободит кэш в этом методе.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamindr_lh.h (включить Wiamindr.h) |