次の方法で共有

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 インターフェイス ポインターを取得する必要があります。

必要条件

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

関連項目

IStillImage::SetDeviceValue

IStillImageW を する