StiCreateInstanceW 函式 (sti.h)
StiCreateInstance 函式會建立 COM 物件的實例,該物件會定義 IStillImage 介面,並傳回介面的指標。
語法
HRESULT StiCreateInstanceW(
HINSTANCE hinst,
DWORD dwVer,
IStillImageW **ppSti,
LPUNKNOWN punkOuter
);
參數
hinst
呼叫端提供的呼叫端實例句柄。 呼叫 GetModuleHandle 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 (include Sti.h) |