IEnumWIA_DEV_CAPS::Next 方法 (wia_xp.h)
IEnumWIA_DEV_CAPS::Next 方法會填入WIA_DEV_CAP結構的指標陣列。
語法
HRESULT Next(
[in] ULONG celt,
[out] WIA_DEV_CAP *rgelt,
[in, out] ULONG *pceltFetched
);
參數
[in] celt
類型: ULONG
指定 rgelt 參數所指示之陣列中的陣列元素數目。
[out] rgelt
類型: WIA_DEV_CAP*
WIA_DEV_CAP 結構的陣列指標。 IEnumWIA_DEV_CAPS::Next 會填入這個結構陣列。
[in, out] pceltFetched
類型: ULONG*
在輸出時,此參數包含實際儲存在 rgelt 參數所指示之陣列中的結構指標數目。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
應用程式會使用這個方法來查詢每個可用的 Windows 映射下載 (WIA) 硬體裝置的功能。 若要這樣做,應用程式會將指標傳遞給它所配置 之WIA_DEV_CAP 結構的陣列。 它也會傳入參數 celt 中的陣列元素數目。 IEnumWIA_DEV_CAPS::Next 方法會將 結構填滿數位。 應用程式接著會使用 結構來列舉 WIA 硬體裝置功能。
WIA 裝置功能定義為裝置支援的事件和命令。 使用 rgelt 陣列 ,IEnumWIA_DEV_CAPS::Next 會針對裝置支援的每個事件和命令,將單一結構傳遞至應用程式。
請注意, IEnumWIA_DEV_CAPS::Next 會動態配置它提供給應用程式的 WIA_DEV_CAP 結構。 因此,應用程式必須刪除他們透過 rgelt 參數收到的WIA_DEV_CAP結構。 應用程式應該使用 SysFreeString 來釋放所有WIA_DEV_CAP結構的 bstrName、bstrDescription 和 bstrIcon 字段。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版、Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wia_xp.h (包括 Wia.h) |
程式庫 | Wiaguid.lib |