IWiaMiniDrv::d rvLockWiaDevice-Methode (wiamindr_lh.h)

Die IWiaMiniDrv::d rvLockWiaDevice-Methode sperrt das WIA-Hardwaregerät, sodass nur der aktuelle Minidriver 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 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 Fehlercodewert 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

Die IWiaMiniDrv::d rvLockWiaDevice--Methode wird verwendet, um den Zugriff auf das Gerät zu sperren. Dies erfolgt in der Regel, bevor Eigenschaften auf das Gerät oder vor einer Datenübertragung geschrieben werden. Die IWiaMiniDrv::d rvLockWiaDevice--Methode sollte mithilfe der IStiDevice--Sperrgerätemethode IStiDevice::LockDeviceimplementiert werden.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- wiamindr_lh.h (include Wiamindr.h)

Siehe auch

IWiaMiniDrv-

IWiaMiniDrv::d rvGetDeviceErrorStr

IWiaMiniDrv::d rvUnLockWiaDevice