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 Statuscode für diese Methode empfängt. Wenn diese Methode S_OKzurückgibt, ist der gespeicherte Wert null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die durch diesen Parameter verwiesen wird.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den durch plDevErrValverwiesen wurde. Wenn die Methode fehlschlägt, sollte ein standardmäßiger COM-Fehlercode zurückgegeben und ein minidriverspezifischer Fehlercode im Speicher platziert werden, auf den plDevErrValverweist.
Der wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStraufgerufen wird.
Bemerkungen
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 freigegeben werden kann. Der Minidriver sollte sämtlichen Speicher freigeben, den er für den Kontext zugewiesen hat. Beispielsweise kann in IWiaMiniDrv::d rvReadItemProperties-ein Kamera-Minidriver einen Cache zuweisen, um die Miniaturansicht für ein Element zu speichern, und einen Zeiger auf diesen Cache im Treiberelementkontext zu speichern. Der Minidriver würde dann den Cache in dieser Methode freigeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamindr_lh.h (include Wiamindr.h) |