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::GetSTILaunchInformationIStillImage::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 时,它才能返回 Unicode 字符串。

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

要求

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

另请参阅

IStillImage::SetDeviceValue

IStillImageW