IStillImageW::SetDeviceValue 方法 (sti.h)

IStillImage::SetDeviceValue 方法设置指定静止映像设备的注册表信息。

语法

HRESULT SetDeviceValue(
  [in] LPWSTR pwszDeviceName,
  [in] LPWSTR pValueName,
       DWORD  Type,
  [in] LPBYTE pData,
       DWORD  cbData
);

参数

[in] pwszDeviceName

调用方提供的指向表示内部设备名称的字符串的指针,通过调用 IStillImage::GetSTILaunchInformationIStillImage::GetDeviceList获取。

[in] pValueName

调用方提供的指向表示注册表值名称的字符串的指针。

Type

调用方提供的REG_前缀注册表值类型。 有关详细信息,请参阅 Microsoft Windows SDK 文档中的 RegSetValueEx

[in] pData

调用方提供的指向要存储的数据的指针。

cbData

pData所指向的数据的调用方提供的大小(以字节为单位)。 对于以 NULL 结尾的字符串,请包含 NULL 字符。

返回值

如果作成功,该方法将返回S_OK。 否则,它将返回在 stierr.h中定义的 STIERR 前缀错误代码之一。

言论

IStillImage::SetDeviceValue 方法的目的是为设备特定的 “静态映像设备”注册表项设置值。 该方法调用 RegSetValueEx(Microsoft Windows SDK 文档中所述)。

在调用 IStillImage::SetDeviceValue之前,IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。

要求

要求 价值
目标平台 桌面
标头 sti.h (include Sti.h)

另请参阅

IStillImage::GetDeviceValue

IStillImageW