次の方法で共有

IStillImageW::CreateDevice メソッド (sti.h)

  • [アーティクル]

IStillImage::CreateDevice メソッドは、IStiDevice COM インターフェイスを定義する COM オブジェクトのインスタンスを作成し、インターフェイスへのポインターを返します。

構文

HRESULT CreateDevice(
  [in]           LPWSTR     pwszDeviceName,
                 DWORD      dwMode,
  [out]          PSTIDEVICE *pDevice,
  [in, optional] LPUNKNOWN  punkOuter
);

パラメーター

[in] pwszDeviceName

IStillImage::GetSTILaunchInformation または IStillImage::GetDeviceListを呼び出して取得した、内部デバイス名を表す文字列への呼び出し元指定ポインター。

dwMode

デバイスが使用される 転送モードを示す呼び出し元指定の定数値。 次の値が有効です。

モード 形容
STI_DEVICE_CREATE_BOTH デバイスは、状態の取得とデータの転送の両方のために開かれています。
STI_DEVICE_CREATE_DATA デバイスは、データ転送用にのみ開かれています。
STI_DEVICE_CREATE_STATUS デバイスは、状態情報を取得するためにのみ開かれています。

[out] pDevice

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

[in, optional] punkOuter

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

戻り値

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

備考

アプリケーションで IStiDevice インターフェイスを使用するには、最初に IStillImage::StiCreateInstance を呼び出して IStillImage インターフェイスへのポインターを取得してから、IStillImage::CreateDevice 呼び出して、IStiDevice インターフェイスへのポインターを取得する必要があります。 pDevice で受け取ったポインターは、後で IStiDevice メソッド 呼び出すときに使用され、サンプルの静止画像コードに示されているように、指定されたデバイスへのアクセスを取得します。

IStiDevice を含む集計 COM オブジェクト作成する場合は、punkOuter で "制御中不明" へのポインター指定する必要があります。 ほとんどの場合、集計オブジェクトを作成しないため、punkOuter NULL する必要があります。 オブジェクトの集計と制御不明については、Microsoft Windows SDK のドキュメントと、コンポーネント オブジェクト モデルの仕様で説明されています。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー sti.h (Sti.h を含む)

関連項目

IStiDevice::Release

IStillImageW を する