共用方式為


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)