共用方式為


wiasGetImageInformation 函式 (wiamdef.h)

wiasGetImageInformation 函式會從專案擷取傳輸內容資訊。

語法

HRESULT wiasGetImageInformation(
  [in]      BYTE                      *pWiasContext,
            LONG                      lFlags,
  [in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);

參數

[in] pWiasContext

WIA 專案內容的指標。

lFlags

指定作業旗標。 目前,只會定義下列旗標:

意義
WIAS_INIT_CONTEXT 初始化 MINIDRV_TRANSFER_CONTEXT 結構。

[in, out] pmdtc

MINIDRV_TRANSFER_CONTEXT 結構的指標。 傳回時,這個結構會包含要求的影像項目資訊。

傳回值

成功時,函式會傳回S_OK。

如果函式失敗,它會傳回標準 COM 錯誤或其中一個 WIA 錯誤碼

言論

此函式會使用 MINIDRV_TRANSFER_CONTEXT 結構來計算專案影像和項目標頭大小。 此外,如果影像格式需要數據標頭,則可以選擇性地填入影像標頭。 如果 pTransferBuffer MINIDRV_TRANSFER_CONTEXT 結構的成員不是 NULL,標頭就會複製到緩衝區。 使用沒有標頭的影像格式(例如 JPEG)時,lHeaderS ize 中的標頭大小會回報為零MINIDRV_TRANSFER_CONTEXT結構的成員。

對於在數據擷取之後才知道影像實際最終大小的影像格式,如同多頁 TIFF 和壓縮格式,lItemSize 結構 MINIDRV_TRANSFER_CONTEXT 的成員會回報為零。 lImageSize 成員會回報為單一頁面中未壓縮影像的大小,以位元組為單位。

如果在 lFlags 參數中指定WIAS_INIT_CONTEXT,pmdtc 參數所指向的MINIDRV_TRANSFER_CONTEXT結構會填入衍生自專案影像屬性的資訊。 當 minidriver 已配置新內容時,應該使用此旗標。

要求

要求 價值
目標平臺 桌面
標頭 wiamdef.h (包括 Wiamdef.h)
連結庫 Wiaservc.lib
DLL Wiaservc.dll

另請參閱

MINIDRV_TRANSFER_CONTEXT