Metodo IStiDevice::LockDevice (sti.h)

Il metodo IStiDevice::LockDevice blocca un dispositivo per l'uso esclusivo da parte del chiamante.

Sintassi

HRESULT LockDevice(
  [in] DWORD dwTimeOut
);

Parametri

[in] dwTimeOut

Valore di timeout fornito dal chiamante, espresso in millisecondi. Se il blocco non viene ottenuto in questo periodo di tempo, viene restituito un errore.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

I client dell'interfaccia IStiDevice COM devono chiamare IStiDevice::LockDevice prima di chiamare i metodi seguenti:

IStiDevice::D eviceReset

IStiDevice::D iagnostic

IStiDevice::Escape

IStiDevice::GetStatus

IStiDevice::RawReadCommand

IStiDevice::RawReadData

IStiDevice::RawWriteCommand

IStiDevice::RawWriteData

Se il metodo IStiDevice::LockDevice è in grado di ottenere un blocco A livello di IStiDevice nel dispositivo entro il periodo di timeout specificato, chiama IStiUSD::LockDevice nel minidriver fornito dal fornitore appropriato.

Ogni chiamata a IStiDevice::LockDevice deve essere associata a una chiamata a IStiDevice::UnLockDevice.

Prima di chiamare IStiDevice::LockDevice, i client dell'interfaccia COM IStiDevice devono chiamare IStillImage::CreateDevice per ottenere un puntatore all'interfaccia IStiDevice , che fornisce l'accesso a un dispositivo specificato.

Requisiti