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 方法的目的是傳回目前指派給仍然映像裝置之裝置特定登錄專案的值。 方法會呼叫 Microsoft Windows SDK 檔) 中所述的 RegQueryValueEx (。
IStillImage::GetDeviceValue 方法可以傳回 ANSI 或 Unicode 字串。 只有當程序代碼是以 Unicode 定義的 Unicode 建置為 Unicode 時,它才能傳回 Unicode 字串。
呼叫 IStillImage::GetDeviceValue 之前, IStillImage COM 介面的客戶端必須呼叫 IStillImage::StiCreateInstance 以取得 IStillImage 介面指標。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sti.h (包含 Sti.h) |