IStillImageW：：CreateDevice 方法 (sti.h)

  • 發行項

IStillImage：：CreateDevice 方法會建立定義 IStiDevice COM 介面的 COM 物件的實例，並傳回介面的指標。

語法

HRESULT CreateDevice(
  [in]           LPWSTR     pwszDeviceName,
                 DWORD      dwMode,
  [out]          PSTIDEVICE *pDevice,
  [in, optional] LPUNKNOWN  punkOuter
);

參數

[in] pwszDeviceName

呼叫端提供的字串指標，代表內部裝置名稱，藉由呼叫 IStillImage：：GetSTILaunchInformation 或 IStillImage：：GetDeviceList 取得。

dwMode

呼叫端提供的常數值，指出要使用裝置的 傳輸模式 。 下列值有效。

模式 Description
STI_DEVICE_CREATE_BOTH 正在開啟裝置，以取得狀態和傳輸數據。
STI_DEVICE_CREATE_DATA 裝置只會針對數據傳輸開啟。
STI_DEVICE_CREATE_STATUS 裝置只會開啟以取得狀態資訊。

[out] pDevice

接收 IStiDevice COM 介面的指標。

[in, optional] punkOuter

選擇性的呼叫端提供的指標，用於物件匯總的「控制未知」。 請參閱下列一節。

傳回值

如果作業成功，方法會傳回S_OK。 否則，它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。

備註

若要讓應用程式使用 IStiDevice 介面，它必須先呼叫 IStillImage：：StiCreateInstance 以取得 IStillImage 介面的指標，然後呼叫 IStillImage：：CreateDevice 以取得 IStiDevice 介面的指標。 在呼叫 IStiDevice 方法時，後續會使用 pDevice 中收到的指標，如範例仍然影像程式代碼所示，以取得指定裝置的存取權。

如果您想要建立包含 IStiDevice 的匯總 COM 物件，您必須在 punkOuter 中提供「控制未知」的指標。 在大部分情況下，您不會建立匯總物件，因此 punkOuter 應該是 NULL。 物件匯總和控制未知描述於 Microsoft Windows SDK 檔和元件物件模型規格中。

規格需求

需求 值
目標平台 桌面
標頭 sti.h (包含 Sti.h)

另請參閱

IStiDevice：：Release

IStillImageW