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 を含む) |