IWiaMiniDrv::d rvLockWiaDevice-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvLockWiaDevice-Methode sperrt das WIA-Hardwaregerät, sodass nur der aktuelle Minitreiber darauf zugreifen kann.
Syntax
HRESULT drvLockWiaDevice(
BYTE *__MIDL__IWiaMiniDrv0030,
LONG __MIDL__IWiaMiniDrv0031,
LONG *__MIDL__IWiaMiniDrv0032
);
Parameter
__MIDL__IWiaMiniDrv0030
lFlags [in]
Reserviert.
__MIDL__IWiaMiniDrv0031
pWiasContext [in]
Zeiger auf einen WIA-Elementkontext.
__MIDL__IWiaMiniDrv0032
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 Fehlercodewert 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
Die IWiaMiniDrv::d rvLockWiaDevice-Methode wird verwendet, um den Zugriff auf das Gerät zu sperren. Dies geschieht in der Regel vor dem Schreiben von Eigenschaften auf das Gerät oder vor einer Datenübertragung. Die IWiaMiniDrv::d rvLockWiaDevice-Methode sollte mithilfe der Lock Device-Methode der IStiDevice-Schnittstelle implementiert werden, IStiDevice::LockDevice.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |