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 |