Compartilhar via


Método IStiDevice::LockDevice (sti.h)

O método IStiDevice::LockDevice bloqueia um dispositivo para uso exclusivo pelo chamador.

Sintaxe

HRESULT LockDevice(
  [in] DWORD dwTimeOut
);

Parâmetros

[in] dwTimeOut

Valor de tempo limite fornecido pelo chamador, em milissegundos. Se o bloqueio não for obtido nesse período de tempo, um erro será retornado.

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

Os clientes da interface COM IStiDevice devem chamar IStiDevice::LockDevice antes de chamar os seguintes métodos:

IStiDevice::D eviceReset

IStiDevice::D iagnostic

IStiDevice::Escape

IStiDevice::GetStatus

IStiDevice::RawReadCommand

IStiDevice::RawReadData

IStiDevice::RawWriteCommand

IStiDevice::RawWriteData

Se o método IStiDevice::LockDevice for capaz de obter um bloqueio no nível de IStiDevice no dispositivo dentro do período de tempo limite especificado, ele chamará IStiUSD::LockDevice no minidriver fornecido pelo fornecedor apropriado.

Cada chamada para IStiDevice::LockDevice deve ser emparelhada com uma chamada para IStiDevice::UnLockDevice.

Antes de chamar IStiDevice::LockDevice, os clientes da interface COM IStiDevice devem chamar IStillImage::CreateDevice para obter um ponteiro de interface IStiDevice , que fornece acesso a um dispositivo especificado.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho sti.h (inclua Sti.h)