共用方式為


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)

另請參閱

IStillImage::Release