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を返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。
戻り値
成功した場合、メソッドは S_OK を返し、plDevErrVal によって指デバイス エラー値をクリアする必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、plDevErrVal が指すメモリにミニドライバー固有のエラー コード配置する必要があります。
plDevErrVal 指す値は、IWiaMiniDrv::d rvGetDeviceErrorStr 呼び出すことによって、文字列に変換できます。
備考
ドライバー項目が削除されると、WIA サービスはドライバー項目のコンテキストを解放します。 このメソッドは、コンテキストを解放する準備ができていることをミニドライバーに通知します。 ミニドライバーは、コンテキストに割り当てられたメモリを解放する必要があります。 たとえば、IWiaMiniDrv::d rvReadItemPropertiesでは、カメラ ミニドライバーは、アイテムのサムネイルを格納し、ドライバー項目コンテキストでこのキャッシュへのポインターを格納するキャッシュを割り当てることができます。 ミニドライバーは、このメソッドのキャッシュを解放します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wiamindr_lh.h (Wiamindr.h を含む) |
関連項目
IWiaMiniDrv の