IStillImageW::SetDeviceValue 方法 (sti.h)
IStillImage::SetDeviceValue 方法會設定指定之仍然映像裝置的登錄資訊。
語法
HRESULT SetDeviceValue(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pValueName,
DWORD Type,
[in] LPBYTE pData,
DWORD cbData
);
參數
[in] pwszDeviceName
呼叫端提供的字串指標,代表內部裝置名稱,藉由呼叫 IStillImage::GetSTILaunchInformation 或 IStillImage::GetDeviceList 取得。
[in] pValueName
呼叫端提供的字串指標,表示登錄值名稱。
Type
呼叫端提供的REG_前置登錄值類型。 如需詳細資訊,請參閱 Microsoft Windows SDK 檔中的 RegSetValueEx。
[in] pData
呼叫端提供要儲存之數據的指標。
cbData
呼叫端提供的大小,以位元組為單位,由 pData 指向的數據。 若為 NULL 終止的字串,請包含 NULL 字元。
傳回值
如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
IStillImage::SetDeviceValue 方法的目的是要為仍映像裝置的裝置特定登錄項目設定值。 方法會呼叫 Microsoft Windows SDK 檔) 中所述的 RegSetValueEx (。
在呼叫 IStillImage::SetDeviceValue 之前, IStillImage COM 介面的客戶端必須呼叫 IStillImage::StiCreateInstance 以取得 IStillImage 介面指標。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sti.h (包含 Sti.h) |