Метод IStiDevice::LockDevice (sti.h)

Метод IStiDevice::LockDevice блокирует устройство для монопольного использования вызывающим методом.

Синтаксис

HRESULT LockDevice(
  [in] DWORD dwTimeOut
);

Параметры

[in] dwTimeOut

Указанное вызывающим значение времени ожидания в миллисекундах. Если блокировка не получена в этот период времени, возвращается ошибка.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Клиенты интерфейса COM IStiDevice должны вызывать IStiDevice::LockDevice перед вызовом следующих методов:

IStiDevice::D eviceReset

IStiDevice::D iagnostic

IStiDevice::Escape

IStiDevice::GetStatus

IStiDevice::RawReadCommand

IStiDevice::RawReadData

IStiDevice::RawWriteCommand

IStiDevice::RawWriteData

Если метод IStiDevice::LockDevice может получить блокировкууровня IStiDevice на устройстве в течение указанного периода ожидания, он вызывает IStiUSD::LockDevice в соответствующем мини-driver, предоставленном поставщиком.

Каждый вызов IStiDevice::LockDevice должен быть связан с вызовом IStiDevice::UnLockDevice.

Перед вызовом IStiDevice::LockDeviceклиенты интерфейса IStiDevice COM должны вызывать IStillImage::CreateDevice, чтобы получить указатель интерфейса IStiDevice, который предоставляет доступ к указанному устройству.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	sti.h (include Sti.h)