iStiDevice::LockDevice 方法 (sti.h)

IStiDevice::LockDevice 方法锁定设备以供调用方独占使用。

语法

HRESULT LockDevice(
  [in] DWORD dwTimeOut
);

参数

[in] dwTimeOut

调用方提供的超时值(以毫秒为单位)。 如果在此时间段内未获取锁,则返回错误。

返回值

如果操作成功,该方法将返回S_OK。 否则,它将返回 stierr.h 中定义的以 STIERR 为前缀的错误代码之一。

注解

IStiDevice COM 接口的客户端必须先调用 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 之前, IStiDevice COM 接口的客户端必须调用 IStillImage::CreateDevice 以获取 IStiDevice 接口指针,该指针提供对指定设备的访问。

要求

要求
目标平台 桌面
标头 sti.h (包括 Sti.h)