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ドキュメントで説明)。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | sti.h (Sti.h を含む) |