IStiDevice::LockDevice-Methode (sti.h)

Die IStiDevice::LockDevice-Methode sperrt ein Gerät zur exklusiven Verwendung durch den Aufrufer.

Syntax

HRESULT LockDevice(
  [in] DWORD dwTimeOut
);

Parameter

[in] dwTimeOut

Vom Aufrufer bereitgestellter Timeoutwert in Millisekunden. Wenn die Sperre in diesem Zeitraum nicht abgerufen wird, wird ein Fehler zurückgegeben.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Clients der IStiDevice COM-Schnittstelle müssen IStiDevice::LockDevice aufrufen, bevor die folgenden Methoden aufgerufen werden:

IStiDevice::D eviceReset

IStiDevice::D iagnostic

IStiDevice::Escape

IStiDevice::GetStatus

IStiDevice::RawReadCommand

IStiDevice::RawReadData

IStiDevice::RawWriteCommand

IStiDevice::RawWriteData

Wenn die IStiDevice::LockDevice-Methode innerhalb des angegebenen Timeoutzeitraums eine Sperre auf IStiDevice-Ebene auf dem Gerät erhalten kann, ruft sie IStiUSD::LockDevice im entsprechenden vom Hersteller bereitgestellten Minitreiber auf.

Jeder Aufruf von IStiDevice::LockDevice muss mit einem Aufruf von IStiDevice::UnLockDevice gekoppelt werden.

Vor dem Aufrufen von IStiDevice::LockDevice müssen Clients der IStiDevice-COM-SchnittstelleIStillImage::CreateDevice aufrufen, um einen IStiDevice-Schnittstellenzeiger abzurufen, der Zugriff auf ein angegebenes Gerät ermöglicht.

Anforderungen