iStillImageW::GetDeviceInfo 方法 (sti.h)
IStillImage::GetDeviceInfo 方法返回指定静止图像设备的硬件特征。
语法
HRESULT GetDeviceInfo(
[in] LPWSTR pwszDeviceName,
[out] LPVOID *ppBuffer
);
参数
[in] pwszDeviceName
调用方提供的指向表示内部设备名称的字符串的指针,该字符串通过调用 IStillImage::GetSTILaunchInformation 或 IStillImage::GetDeviceList 获取。
[out] ppBuffer
接收 STI_DEVICE_INFORMATION 结构的句柄。
返回值
如果操作成功,该方法将返回S_OK。 否则,它将返回 stierr.h 中定义的以 STIERR 为前缀的错误代码之一。
注解
IStillImage::GetDeviceInfo 方法返回指定静止图像设备的STI_DEVICE_INFORMATION结构。 结构内容通常用于创建用户界面显示。
在调用 IStillImage::GetDeviceInfo 之前, IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。
调用方使用 ppBuffer 引用的 STI_DEVICE_INFORMATION 结构后,必须通过调用 Microsoft Windows SDK 文档) 中所述的 LocalFree (解除分配缓冲区。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (包括 Sti.h) |