次の方法で共有


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

IStillImage::GetDeviceInfo メソッドは、指定された静止画像デバイスのハードウェア特性を返します。

構文

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

パラメーター

[in] pwszDeviceName

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

[out] ppBuffer

STI_DEVICE_INFORMATION 構造体へのハンドルを受け取ります。

戻り値

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

備考

IStillImage::GetDeviceInfo メソッドは、指定した静止画像デバイスの STI_DEVICE_INFORMATION 構造体を返します。 構造体の内容は、通常、ユーザー インターフェイスの表示を作成するために使用されます。

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

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

必要条件

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

関連項目

IStillImage::GetDeviceList

IStillImageW する