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 方法仅允许修改与尚未标识总线的仍图像设备关联的设备参数。 对于此类设备,当调用 IStillImage::GetDeviceInfo 时,静止映像服务器会将设备的 STI_DEVICE_INFORMATION 结构的 dwHardwareConfiguration 成员设置为STI_HW_CONFIG_UNKNOWN。
目前,唯一可修改的设备参数是设备的端口名称。 调用此方法以修改端口名称时,必须指定 dwSize、szDeviceInternalName,以及 pszPortName STI_DEVICE_INFORMATION的成员。 将忽略所有其他成员。
在调用 IStillImage::SetupDeviceParameters之前,IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (include Sti.h) |