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) |