IStillImageW::SetupDeviceParameters 方法 (sti.h)
IStillImage::SetupDeviceParameters 方法可讓 IStillImage COM 介面的用戶端在裝置的總線類型未知時,修改仍然儲存的影像裝置特性。
語法
HRESULT SetupDeviceParameters(
[in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);
參數
[in, out] unnamedParam1
定義 unnamedParam1PSTI_DEVICE_INFORMATIONW 參數。
傳回值
如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
IStillImage::SetupDeviceParameters 方法只允許修改與尚未識別總線之仍然映像裝置相關聯的裝置參數。 針對這類裝置,仍為映射伺服器會在呼叫 IStillImage::GetDeviceInfo 時,將裝置STI_DEVICE_INFORMATION結構的 dwHardwareConfiguration 成員設定為STI_HW_CONFIG_UNKNOWN。
目前,唯一可以修改的裝置參數是裝置的埠名稱。 呼叫這個方法來修改埠名稱時,必須指定STI_DEVICE_INFORMATION的 dwSize、 szDeviceInternalName 和 pszPortName 成員。 所有其他成員都會被忽略。
呼叫 IStillImage::SetupDeviceParameters 之前, IStillImage COM 介面的客戶端必須呼叫 IStillImage::StiCreateInstance 以取得 IStillImage 介面指標。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sti.h (包含 Sti.h) |