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结构数组后,它必须通过调用 LocalFree(Microsoft Windows SDK 文档中所述)解除分配数组。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (include Sti.h) |