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.h 中定義STI_VERSION。
dwMode
呼叫端提供的常數值,指出要使用裝置的 傳輸模式 。 下列值有效。
模式 | Description |
---|---|
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) |