IStillImageW::GetDeviceList 方法 (sti.h)

IStillImage::GetDeviceList 方法返回所有已安装的静态映像设备的硬件特征。

语法

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

参数

dwType

保留参数,使用 NULL

dwFlags

保留参数,使用 NULL

[out] pdwItemsReturned

接收 ppBuffer 引用的缓冲区中提供的STI_DEVICE_INFORMATION结构数。

[out] ppBuffer

接收 STI 分配的缓冲区的句柄。 此缓冲区将包含 STI_DEVICE_INFORMATION 结构的数组。

返回值

如果操作成功,该方法将返回S_OK。 否则,它将返回 stierr.h 中定义的 STIERR 前缀错误代码之一。

注解

IStillImage::GetDeviceList 方法为每个已安装的静态映像设备返回STI_DEVICE_INFORMATION结构。 结构内容通常用于创建用户界面显示器和查找设备的内部名称。

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

调用方使用 ppBuffer 引用的STI_DEVICE_INFORMATION结构数组后,必须通过调用 Microsoft Windows SDK 文档) 中所述的 LocalFree (解除分配数组。

要求

要求
目标平台 桌面
标头 sti.h (包括 Sti.h)

另请参阅

IStillImage::GetDeviceInfo

IStillImageW