次の方法で共有

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

  • [アーティクル]

IStillImage::GetDeviceList メソッドは、インストールされているすべての静止画像デバイスのハードウェア特性を返します。

構文

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

パラメーター

dwType

予約済みパラメーター NULLを使用します。

dwFlags

予約済みパラメーター NULLを使用します。

[out] pdwItemsReturned

ppBuffer によって参照されるバッファーに指定されたSTI_DEVICE_INFORMATION構造体数を受け取ります。

[out] ppBuffer

STI によって割り当てられたバッファーへのハンドルを受け取ります。 このバッファーには、STI_DEVICE_INFORMATION 構造体の配列が含まれます。

戻り値

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

備考

IStillImage::GetDeviceList メソッドは、インストールされている各静止イメージ デバイスの STI_DEVICE_INFORMATION 構造体を返します。 構造体の内容は、通常、ユーザー インターフェイスの表示を作成し、デバイスの内部名を検索するために使用されます。

IStillImage::GetDeviceListを呼び出す前に、IStillImage COM インターフェイスのクライアントが IStillImage::StiCreateInstance 呼び出して、IStillImage インターフェイス ポインターを取得する必要があります。

呼び出し元が ppBuffer によって参照されるSTI_DEVICE_INFORMATION構造体の配列の使用完了したら、LocalFree 呼び出して配列の割り当てを解除する必要があります (Microsoft Windows SDK ドキュメントで説明)。

必要条件

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

関連項目

IStillImage::GetDeviceInfo

IStillImageW を する