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 では、カメラ ミニドライバーがキャッシュを割り当ててアイテムのサムネイルを格納し、ドライバーアイテムコンテキストにこのキャッシュへのポインターを格納する場合があります。 その後、ミニドライバーは、このメソッドのキャッシュを解放します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamindr_lh.h (Wiamindr.h を含む) |