Метод 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 в соответствующем мини-накопителе, предоставленном поставщиком.

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

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

Требования