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