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 結構來計算專案影像和項目標頭大小。 此外，如果影像格式需要數據標頭，可以選擇性地填入影像標頭。 如果MINIDRV_TRANSFER_CONTEXT結構的 pTransferBuffer 成員不是 NULL，標頭將會複製到緩衝區。 使用沒有標頭的 JPEG) 等影像格式 (時，MINIDRV_TRANSFER_CONTEXT 結構的 lHeaderSize 成員中的標頭大小會回報為零。
對於在數據擷取之後，影像的實際最終大小未知的影像格式，如同多頁 TIFF 和壓縮格式，MINIDRV_TRANSFER_CONTEXT 結構的 lItemSize 成員會回報為零。 lImageSize 成員會回報為單一頁面中未壓縮影像的大小，以位元組為單位。
如果在 lFlags 參數中指定 WIAS_INIT_CONTEXT，pmdtc 參數所指向的MINIDRV_TRANSFER_CONTEXT結構會填入衍生自專案影像屬性的資訊。 當迷你驅動程式已配置新的內容時，應該使用此旗標。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | wiamdef.h (包含Wiamdef.h) |
| 程式庫 | Wiaservc.lib |
| Dll | Wiaservc.dll |