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) |