IStillImageW::GetDeviceInfo 方法 (sti.h)

IStillImage::GetDeviceInfo 方法返回指定静止图像设备的硬件特征。

语法

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

参数

[in] pwszDeviceName

调用方提供的指向表示内部设备名称的字符串的指针,通过调用 IStillImage::GetSTILaunchInformationIStillImage::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结构完成后,它必须通过调用 LocalFree(Microsoft Windows SDK 文档中所述)解除分配缓冲区。

要求

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

另请参阅

IStillImage::GetDeviceList

IStillImageW