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：：Initialize 由 IStillImage：：CreateDevice 调用， 因此 IStiDevice 接口的客户端通常不会直接调用此方法。

要求

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