IWiaMiniDrv::d rvFreeDrvItemContext-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvFreeDrvItemContext-Methode gibt einen gerätespezifischen Kontext frei.
Syntax
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Parameter
__MIDL__IWiaMiniDrv0056
lFlags [in]
Reserviert.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Verweist auf einen gerätespezifischen Kontext.
__MIDL__IWiaMiniDrv0058
plDevErrVal [out]
Verweist auf einen Speicherspeicherort, der einen status Code für diese Methode erhält. Wenn diese Methode S_OK zurückgibt, ist der gespeicherte Wert 0. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die dieser Parameter verweist.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den von plDevErrVal verwiesen wird. Wenn die Methode fehlschlägt, sollte sie einen COM-Standardfehlercode zurückgeben und einen minidriverspezifischen Fehlercode im Speicher platzieren, auf den von plDevErrVal verwiesen wird.
Der Wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStr aufgerufen wird.
Hinweise
Wenn ein Treiberelement gelöscht wird, gibt der WIA-Dienst den Kontext des Treiberelements frei. Diese Methode informiert den Minidriver darüber, dass der Kontext bereit ist, freigegeben zu werden. Der Minidriver sollte den Speicher freigeben, den er für den Kontext zugewiesen hat. Beispielsweise kann in IWiaMiniDrv::d rvReadItemProperties ein Kamera-Minidriver einen Cache zuordnen, um die Miniaturansicht für ein Element zu speichern, und einen Zeiger auf diesen Cache im Kontext des Treiberelements speichern. Der Minidriver würde dann den Cache in dieser Methode freigeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |