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