共用方式為


StiCreateInstanceW 函式 (sti.h)

StiCreateInstance 函式會建立定義 IStillImage 介面的 COM 物件的實例,並傳回介面的指標。

語法

HRESULT StiCreateInstanceW(
  HINSTANCE    hinst,
  DWORD        dwVer,
  IStillImageW **ppSti,
  LPUNKNOWN    punkOuter
);

參數

hinst

呼叫端提供的呼叫端實例句柄。 呼叫 GetModuleHandle (NULL) 即可取得此句柄。

dwVer

呼叫端提供的 STI 版本號碼。 此值必須STI_VERSION,定義於 Sti.h 中。

ppSti

接收 IStillImage 介面的指標。

punkOuter

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

傳回值

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

備註

若要讓應用程式使用 IStillImage 介面,它必須先呼叫 StiCreateInstance 函式,以取得介面的指標。 後續呼叫 IStillImage 方法時,會使用 ppSti 中收到的指標,如下列範例所示:

PSTI pSti = NULL;
DWORD dwStiTotal = 0;     // total number of STI devices found
PVOID pStiInfo = NULL;    // STI device info buffer
HRESULT hres = StiCreateInstance(GetModuleHandle(NULL), STI_VERSION, &pSti, NULL);
...
hhes = pSti->GetDeviceList(0, 0, &dwStiTotal, &pStiInfo);

如果您想要建立包含 IStillImage 的匯總 COM 物件,您必須在 punkOuter 中提供「控制未知」的指標。 在大部分情況下,您不會建立匯總物件,因此 punkOuter 應該是 NULL。 「 匯總 」一文和 「元件物件模型規格」會說明對象匯總和控制未知。

規格需求

需求
標頭 sti.h (包含 Sti.h)

另請參閱

IStillImage::Release