共用方式為


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::GetSTILaunchInformationIStillImage::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 (include Sti.h)

另請參閱

IStillImage::SetDeviceValue

IStillImageW