IStiDevice::Initialize 方法 (sti.h)

此方法仅供内部使用。

IStiDevice::Initialize 方法初始化定义 IStiDevice 接口的 COM 对象的实例。

语法

HRESULT Initialize(
  [in] HINSTANCE hinst,
  [in] LPCWSTR   pwszDeviceName,
       DWORD     dwVersion,
       DWORD     dwMode
);

参数

[in] hinst

调用方提供的调用进程的实例句柄。 通过调用 GetModuleName(NULL)来获取此句柄。

[in] pwszDeviceName

调用方提供的指向表示内部设备名称的字符串的指针,通过调用 IStillImage::GetSTILaunchInformation获取。

dwVersion

调用方提供的 STI 版本号。 此值必须STI_VERSION,Sti.h中定义。

dwMode

调用方提供的常量值,指示要使用的设备 传输模式。 以下值有效。

模式 描述
STI_DEVICE_CREATE_BOTH 正在打开设备以获取状态和传输数据。
STI_DEVICE_CREATE_DATA 设备仅在数据传输时打开。
STI_DEVICE_CREATE_STATUS 仅打开设备以获取状态信息。

返回值

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

言论

IStiDevice::Initialize 方法初始化通过调用 IStillImage::CreateDevice创建的 COM 对象实例。

由于 IStiDevice::InitializeIStillImage::CreateDevice调用,因此 IStiDevice 接口的客户端通常不直接调用此方法。

要求

要求 价值
目标平台 桌面
标头 sti.h (include Sti.h)