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)