StiCreateInstanceW 関数 (sti.h)

StiCreateInstance 関数は、IStillImage インターフェイスを定義する COM オブジェクトのインスタンスを作成し、インターフェイスへのポインターを返します。

構文

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

パラメーター

hinst

呼び出し元が指定した呼び出し元プロセスのインスタンス ハンドル。 このハンドルは、 GetModuleHandle(NULL) を呼び出すことによって取得されます。

dwVer

呼び出し元が指定した STI バージョン番号。 この値は、 Sti.h で定義STI_VERSIONする必要があります。

ppSti

IStillImage インターフェイスへのポインターを受け取ります。

punkOuter

オブジェクト集計の "制御する不明" への呼び出し元指定のポインター (省略可能)。 次の 「備考」セクションを 参照してください。

戻り値

操作が成功した場合、メソッドは S_OKを返します。 それ以外の場合は、 stierr.h で定義されている STIERR プレフィックス付きエラー コードのいずれかを返します。

注釈

アプリケーションで IStillImage インターフェイスを使用するには、最初に StiCreateInstance 関数を呼び出してインターフェイスへのポインターを取得する必要があります。 次の例に示すように、 ppSti で受信したポインターは、 IStillImage メソッドを呼び出すときに、その後使用されます。

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 にする必要があります。 オブジェクトの集計と制御の不明については、 集計 に関する記事と コンポーネント オブジェクト モデルの仕様に関する記事を参照してください。

要件

要件	値
Header	sti.h (Sti.h を含む)

こちらもご覧ください

IStillImage::Release