Share via


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結構的 bstrNamebstrDescriptionbstrIcon 字段。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 wia_xp.h (包括 Wia.h)
程式庫 Wiaguid.lib