IStillImageW::GetDeviceValue メソッド (sti.h)
IStillImage::GetDeviceValue メソッドは、指定された静止画像デバイスに関連付けられているレジストリ情報を返します。
構文
HRESULT GetDeviceValue(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pValueName,
[out] LPDWORD pType,
[out] LPBYTE pData,
[in, out] LPDWORD cbData
);
パラメーター
[in] pwszDeviceName
IStillImage::GetSTILaunchInformation または IStillImage::GetDeviceList を呼び出すことによって取得される、内部デバイス名を表す文字列への呼び出し元指定のポインター。
[in] pValueName
レジストリ値名を表す文字列への呼び出し元指定ポインター。
[out] pType
返されたレジストリ値のデータ型を表す定数を受け取ります。
[out] pData
戻り値を受け取るバッファーへの呼び出し元指定ポインター。
[in, out] cbData
pData が指すバッファーの呼び出し元が指定したサイズ (バイト単位)。 メソッドは、返されるデータのサイズを表すようにこの値を変更します。 指定したバッファー サイズが小さすぎる場合、メソッドは必要なバッファー サイズを提供し、エラー コードを返します。
戻り値
操作が成功した場合、メソッドは S_OKを返します。 それ以外の場合は、 stierr.h で定義されている STIERR プレフィックス付きのエラー コードのいずれかを返します。
注釈
IStillImage::GetDeviceValue メソッドの目的は、現在、静止画像デバイスのデバイス固有のレジストリ エントリに割り当てられている値を返します。 メソッドは RegQueryValueEx を呼び出します (Microsoft Windows SDKドキュメントで説明されています)。
IStillImage::GetDeviceValue メソッドは、ANSI または Unicode 文字列を返すことができます。 Unicode 文字列を返すことができるのは、Unicode が定義された Unicode としてコードがビルドされている場合のみです。
IStillImage::GetDeviceValue を呼び出す前に、IStillImage COM インターフェイスのクライアントは IStillImage::StiCreateInstance を呼び出して IStillImage インターフェイス ポインターを取得する必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | sti.h (Sti.h を含む) |