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 字符串。
在调用 IStillImage::GetDeviceValue 之前, IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (包括 Sti.h) |