次の方法で共有

StiCreateInstanceW 関数 (sti.h)

  • [アーティクル]

TiCreateInstance 関数は、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 する必要があります。 オブジェクト集計と制御不明については、集計 に関する記事および「コンポーネント オブジェクト モデルの仕様」で説明されています。

必要条件

要件 価値
ヘッダー sti.h (Sti.h を含む)

関連項目

IStillImage::Release