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) |