IStillImageW：：SetupDeviceParameters 方法 (sti.h)

  • 项目

如果设备的总线类型未知， IStillImage：：SetupDeviceParameters 方法允许 IStillImage COM 接口的客户端修改静态图像设备的存储特征。

语法

HRESULT SetupDeviceParameters(
  [in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);

参数

[in, out] unnamedParam1

定义 PSTI_DEVICE_INFORMATIONW 参数 unnamedParam1。

返回值

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

注解

IStillImage：：SetupDeviceParameters 方法仅允许修改与尚未标识总线的静态图像设备关联的设备参数。 对于此类设备，静态映像服务器将设备的STI_DEVICE_INFORMATION结构的 dwHardwareConfiguration 成员设置为在调用 IStillImage：：GetDeviceInfo 时STI_HW_CONFIG_UNKNOWN。

目前，唯一可以修改的设备参数是设备的端口名称。 调用此方法以修改端口名称时，必须指定STI_DEVICE_INFORMATION的 dwSize、 szDeviceInternalName 和 pszPortName 成员。 将忽略所有其他成员。

在调用 IStillImage：：SetupDeviceParameters 之前， IStillImage COM 接口的客户端必须调用 IStillImage：：StiCreateInstance 以获取 IStillImage 接口指针。

要求

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