掃描器 WIA 專案屬性常數

發行項
09/03/2023

下列常數會指定一組有效的 Windows 映像取得 (WIA) 掃描器專案屬性。

前置詞「WIA_IPS_」表示掃描器裝置的專案屬性，而且是 C/C++ 中使用的命名慣例。針對腳本用途，這些常數會使用前置詞「ScannerPicture」，而且是 WiaItemPropertyId 列舉類型的一部分。來自該腳本列舉的對應成員名稱會出現在下列清單中的 C/C++ 常數名稱旁的括弧中。

常數/值描述

WIA_IPS_AUTO_DESKEW
ScannerPictureAutoDeskew

注意：
只有 Windows Vista 和更新版本才支援此屬性。

開啟或關閉自動桌面。
僅適用于 WIA_CATEGORY_FEEDER。
類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST
下表具有這個屬性有效的常數。

常數	描述
WIA_AUTO_DESKEW_ON	開啟自動桌面。
WIA_AUTO_DESKEW_OFF	關閉自動桌面。

WIA_IPS_BRIGHTNESS
ScannerPictureBrightness

掃描器內可用的影像亮度值。

包含裝置目前的硬體亮度設定。應用程式會將此屬性設定為硬體的亮度值。迷你驅動程式會建立和維護這個屬性。

值應該對應在介於 -1000 到 1000 的範圍中，其中 1000 對應到最大亮度，0 對應至一般亮度，而 -1000 對應到最小亮度。

類別中的所有專案都需要：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。選擇性，但建議用於支援預覽WIA_CATEGORY_FINISHED_FILE專案。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_CONTRAST
ScannerPictureContrast

包含裝置目前的硬體對比設定。應用程式會將此屬性設定為硬體的對比值。迷你驅動程式會建立和維護這個屬性。

值應該對應在介於 -1000 到 1000 的範圍中，其中 -1000 對應到最小對比，0 對應至一般對比，而 1000 對應到最大對比。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_CUR_INTENT
ScannerPictureCurIntent

包含目前的意圖設定。迷你驅動程式會建立和維護這個屬性。

所有啟用下載專案的必要專案;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。不支援WIA_CATEGORY_FINISHED_FILE或WIA_CATEGORY_FOLDER專案。

類型： VT_I4 存取：讀取/寫入、有效值： WIA_PROP_FLAGS

驅動程式會根據應用程式的預期影像用途，使用這些屬性來預設專案屬性。這可能包括，例如品質上限、大小下限等等。

驅動程式會選擇位深度，以點為單位每英吋，以及它決定的其他設定適用于選取的意圖。應用程式必須讀取目前的設定，以判斷哪些屬性已變更。應用程式會將此屬性設定為針對特定擷取意圖自動設定 WIA 屬性。所有掃描器都需要這個屬性。

應用程式會將此屬性設定為針對特定擷取意圖自動設定 WIA 屬性

注意：
旗標可以與位 OR 運算子結合，但影像不能同時為灰階和色彩。

所有掃描器都需要這個屬性。

下表包含影像類型旗標及其定義。這些旗標可用來設定要使用的影像類型：色彩、灰階等等。

預定的影像類型旗標	描述
WIA_INTENT_NONE	預設值。未指定意圖。
WIA_INTENT_IMAGE_TYPE_COLOR	應用程式想要準備裝置以進行色彩掃描。
WIA_INTENT_IMAGE_TYPE_GRAYSCALE	應用程式想要準備裝置以進行灰階掃描。
WIA_INTENT_IMAGE_TYPE_TEXT	應用程式想要準備裝置以掃描文字。
WIA_INTENT_IMAGE_TYPE_MASK	所有影像類型旗標的遮罩。

下表包含品質和大小旗標及其定義。這些旗標是用來設定要何種品質等級。

預定的影像大小/品質旗標	描述
WIA_INTENT_MINIMIZE_SIZE	應用程式想要準備裝置以掃描導致小型掃描的影像。
WIA_INTENT_MAXIMIZE_QUALITY	應用程式想要準備裝置以掃描高品質的影像。
WIA_INTENT_SIZE_MASK	此旗標是所有大小/品質旗標的遮罩。
WIA_INTENT_BEST_PREVIEW	應用程式想要準備裝置以掃描預覽。

WIA_IPS_DESKEW_X
ScannerPictureDeskewX

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含 x 方向的圖元數，從WIA_IPS_XPOS到要桌面顯示之影像左上角的 X 座標。因此，它會與WIA_IPS_DESKEW_Y一起使用，其中扭曲影像的兩個左上角位於WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT所定義的周框內。如果掃描器驅動程式支援桌面，則其屬性會由掃描器驅動程式實作。

WIA_IPS_DESKEW_X的有效值必須介於 0 到 (WIA_IPS_XEXTENT - 1) 之間。值為 0 表示不應執行任何桌面。

對於類別WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM的專案而言，這個屬性是選擇性的;而且不適用於WIA_CATEGORY_FINISHED_FILE或WIA_CATEGORY_FOLDER專案。

類型： VT_I4、Access：讀取/寫入、有效值：WIA_PROP_RANGE

WIA_IPS_DESKEW_Y
ScannerPictureDeskewY

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含從WIA_IPS_YPOS到要桌面之影像最左邊角落的 Y 座標的 Y 方向圖元數目。因此，它會與WIA_IPS_DESKEW_X一起使用，其中扭曲影像的兩個左上角位於WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT所定義的周框內。如果掃描器驅動程式支援桌面，這個屬性會由掃描器驅動程式實作。

WIA_IPS_DESKEW_Y的有效值必須介於 0 到 (WIA_IPS_YEXTENT - 1) 之間。值為 0 表示不應執行任何桌面。

對於類別WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM的專案而言，這個屬性是選擇性的;而且不適用於WIA_CATEGORY_FINISHED_FILE或WIA_CATEGORY_FOLDER專案。

類型： VT_I4、Access：讀取/寫入、有效值：WIA_PROP_RANGE

WIA_IPS_DOCUMENT_HANDLING_SELECT
ScannerPictureDocumentHandlingSelect

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含目前的掃描器取得來源和模式。迷你驅動程式會建立和維護這個屬性。

應用程式會讀取此屬性，以判斷掃描器目前的取得來源，或撰寫此屬性以設定掃描器的來源和模式。此外，應用程式會使用此屬性來啟用和停用雙工工具功能。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_FLAG

下表具有這個屬性有效的常數。

Flags	描述
雙工	使用雙工器作業進行掃描。使用針對摘要器專案設定的一般設定來掃描這兩個檔端 (WIA_CATEGORY_FEEDER) 。無法同時設定雙工和ADVANCE_DUPLEX。
ADVANCED_DUPLEX	使用針對每個子摘要器專案 (WIA_CATEGORY_FEEDER_FRONT 和WIA_CATEGORY_FEEDER_BACK) 設定的個別設定進行掃描。無法同時設定雙工和ADVANCE_DUPLEX。
FRONT_FIRST	先掃描檔的前面。設定 DUPLEX 或 ADVANCED_DUPLEX 時，這個值有效。
BACK_FIRST	先掃描檔背面。設定 DUPLEX 或 ADVANCED_DUPLEX 時，這個值有效。
FRONT_ONLY	僅掃描前端。
BACK_ONLY	僅掃描上一頁。設定 DUPLEX 或 ADVANCED_DUPLEX 時，這個值有效。

WIA_IPS_FILM_NODE_NAME
ScannerPictureFilmNodeName

注意：
只有 Windows Vista 和更新版本才支援此屬性。

當有多個電影掃描附件時，啟用特定電影掃描附件的規格。

當有多個電影掃描專案時，WIA_CATEGORY_FILM專案需要這個屬性。如果裝置只支援一個根掃描器電影專案，則此屬性是選擇性的。

類型： VT_BSTR、Access：唯讀、有效值： WIA_PROP_NONE

允許的值：BSTR 的格式應該是 @ResourceBinary，- < ResourceID > 允許當地語系化，因為此字串會透過電影掃描 UI 向使用者公開。

WIA_IPS_FILM_SCAN_MODE
ScannerPictureFilmScanMode

注意：
只有 Windows Vista 和更新版本才支援此屬性。

啟用目前電影掃描的設定。

WIA_CATEGORY_FILM專案需要這個屬性。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表具有這個屬性有效的常數。

常數	描述
WIA_FILM_COLOR_SLIDE	掃描色彩投影片。
WIA_FILM_COLOR_NEGATIVE	掃描色彩為負數。
WIA_FILM_BW_NEGATIVE	掃描黑白負數。

WIA_IPS_INVERT
ScannerPictureInvert

保留供日後使用，目前不會實作。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
ScannerPictureInvert

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定WIA_CATEGORY_FOLDER專案中儲存的專案數目。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_LAMP
ScannerPictureLamp

注意：
只有 Windows Vista 和更新版本才支援此屬性。

開啟或關閉掃描器燈。

選擇性用於WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM專案，並建議用於WIA_CATEGORY_FILM。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表具有這個屬性有效的常數。

常數	描述
WIA_LAMP_ON	開啟燈光。
WIA_LAMP_OFF	關閉燈光。

WIA_IPS_LAMP_AUTO_OFF
ScannerPictureLampAutoOff

注意：
只有 Windows Vista 和更新版本才支援此屬性。

設定未使用掃描器時，將燈光保持開啟的時間上限。

選擇性用於WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER和WIA_CATEGORY_FILM專案，並建議用於WIA_CATEGORY_FILM。

類型： VT_UI4、Access：讀取/寫入、有效值：0 - 0xFFF秒

WIA_IPS_MAX_HORIZONTAL_SIZE
ScannerPictureMaxHorizontalSize

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定在目前解析度的水準 (X) 軸中掃描的最大寬度，以千分之一英吋為單位。這可能是工作表送紙器的寬度，或根據專案類型掃描的紙張。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_MAX_VERTICAL_SIZE
ScannerPictureMaxVerticalSize

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定在目前解析度的垂直 (Y) 軸中掃描的最大高度，以千分之一英吋為單位。這可能是工作表饋送器的高度，或根據專案類型掃描紙。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_MIN_HORIZONTAL_SIZE
ScannerPictureMinHorizontalSize

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定目前解析度在水準 (X) 軸中掃描的最小寬度，以千分之一英吋為單位。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_MIN_VERTICAL_SIZE
ScannerPictureMinVerticalSize

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定在目前解析度的垂直 (Y) 軸中掃描的最小高度，以千分之一英吋為單位。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_MIRROR
ScannerPictureMirror

保留供日後使用，目前未實作。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_OPTICAL_XRES
ScannerPictureOpticalXres

注意：
只有 Windows Vista 和更新版本才支援此屬性。

水準光學解析度。 DPI 中支援的最高水準光學解析度。這個屬性是單一值。這不是裝置可產生的所有解析度清單。相反地，這是裝置的光學解析度。 minidriver 會建立和維護這個屬性。所有專案都需要這個屬性。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_OPTICAL_YRES
ScannerPictureOpticalYres

注意：
只有 Windows Vista 和更新版本才支援此屬性。

垂直光學解析度。 DPI 中支援的最高垂直光學解析度。這個屬性是單一值。這不是裝置所產生的所有解析度清單。相反地，這是裝置的光學解析度。 minidriver 會建立和維護這個屬性。所有專案都需要這個屬性。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_ORIENTATION
ScannerPictureOrientation

指定要掃描之檔的目前方向。 minidriver 會建立和維護這個屬性。

應用程式會設定這個屬性，以定義要取得的頁面或影像的原始方向。如需如何使用WIA_IPS_ORIENTATION的資訊，請參閱 WIA_IPS_PAGE_SIZE。

注意：
WIA_IPS_ORIENTATION是指要掃描的檔在掃描器台或饋送器上的位置。這是相對於掃描方向的檔方向。 WIA_IPS_ROTATION是指在掃描影像之後套用至影像的旋轉，緊接在影像傳送至應用程式之前。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表有四個常數，這些常數在此屬性中有效。

值	定義
肖像	0 度。
橫向	相對於 PORTRAIT 方向的 90 度反順時針旋轉。
ROT180	相對於 PORTRAIT 方向的 180 度反順時針旋轉。
ROT270	相對於 PORTRAIT 方向的 270 度反順時針旋轉。

WIA_IPS_PAGE_SIZE
ScannerPicturePageSize

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含目前設定為掃描的頁面大小。應用程式會將此屬性設定為選取要掃描的頁面維度。 minidriver 會建立和維護這個屬性。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

如需可與此屬性搭配使用的常數，請參閱 WIA 2.0 頁面大小常數。請注意這些非固定大小，特別是：

值	定義
WIA_PAGE_CUSTOM	由 WIA_IPS_PAGE_HEIGHT 和 WIA_IPS_PAGE_WIDTH 屬性的值所定義。
WIA_PAGE_AUTO	頁面大小會自動由裝置決定。
WIA_PAGE_CUSTOM_BASE	應用程式與設備磁碟機已經知道其維度的自訂頁面大小。

WIA_IPS_ORIENTATION屬性的值會決定目前選取頁面的方向。 WIA_IPS_PAGE_WIDTH和WIA_IPS_PAGE_HEIGHT屬性會以千英吋為單位來報告頁面的維度。這些屬性必須與 WIA_IPS_XEXTENT 和 WIA_IPS_YEXTENT合約，其中包含以圖元為單位的頁面維度。

注意：
WIA_PROP_LIST類型的有效值取決於 WIA_IPS_ORIENTATION 屬性的有效設定。例如，如果裝置無法掃描具有WIA_PAGE_A4設定的橫向檔，WIA_PAGE_A4不是WIA_IPS_ORIENTATION設定為 LANDSCAPE 時，WIA_IPS_PAGE_SIZE屬性的有效值。

如果應用程式將 WIA_IPS_PAGE_SIZE 設定為上表中三個以外的任何值，minidriver 應該調整 WIA_IPS_PAGE_WIDTH 的值，並將 WIA_IPS_PAGE_HEIGHT 以千英吋為單位的頁面維度。它也應該調整 WIA_IPS_XEXTENT 的值，並將 WIA_IPS_YEXTENT 調整為以圖元為單位的頁面維度。

如果範圍設定 (WIA_IPS_XEXTENT 或 WIA_IPS_YEXTENT) 變更為不符合目前頁面大小設定的值，minidriver 應該將 WIA_IPS_PAGE_SIZE 屬性值變更為 WIA_PAGE_CUSTOM。 minidriver 也應該根據新的範圍設定修改 WIA_IPS_PAGE_WIDTH 或 WIA_IPS_PAGE_HEIGHT 。

如果 WIA_IPS_ORIENTATION 設定為 LANDSCAPE，範圍設定將會與其一般值相對交換。例如，如果應用程式將 WIA_IPS_PAGE_SIZE 設為 WIA_PAGE_A4，minidriver 會將 WIA_IPS_PAGE_WIDTH 設定為 11692， 並將 WIA_IPS_PAGE_HEIGHT 設為 8267。 (minidriver 也應該據 以調整WIA_IPS_XEXTENT 和 WIA_IPS_YEXTENT 。)

注意：
如果 WIA_IPS_PAGE_SIZE 設定為 WIA_PAGE_CUSTOM，則不會使用方向設定來判斷要掃描的頁面範圍維度。

minidriver 負責確保 WIA_IPS_ORIENTATION 屬性與目前的選取區域一起。如果應用程式將 WIA_IPS_ORIENTATION 的值變更為目前所選頁面大小不正確值，minidriver 應該將 WIA_IPS_PAGE_SIZE 的值變更為新方向值所支援的頁面大小。

如果應用程式將 WIA_IPS_PAGE_SIZE 屬性設定為 WIA_PAGE_CUSTOM，則目前的選取區域不會受到影響。 WIA 迷你驅動程式應該從WIA_IPS_XPOS和WIA_IPS_YPOS屬性的目前設定開始取得目前的影像配置。如果頁面大小設定導致掃描器的台外選取區域，迷你驅動程式必須自動調整 WIA_IPS_XPOS 的值，並將屬性 WIA_IPS_YPOS 屬性的值調整為有效的設定。如果 同時設定WIA_IPS_PAGE_SIZE 和 WIA_IPS_ORIENTATION 屬性，而且在結合套用時無效，迷你驅動程式應該會傳回 IWiaMiniDrv：:d rvValidateItemProperties中的錯誤，讓應用程式的設定失敗。

下列四個範例顯示不同的 WIA_IPS_PAGE_SIZE 案例。

驅動程式會報告設定。
應用程式會將 WIA_IPS_PAGE_SIZE 屬性設定為 WIA_PAGE_LETTER。
應用程式會將 WIA_IPS_ORIENTATION 屬性設定為 LANDSCAPE。
應用程式會將 WIA_IPS_XEXTENT 屬性變更為較小的值。

範例 1：迷你驅動程式會報告設定

在下列範例中，minidriver 會在應用程式設定任何 WIA 屬性之前設定自訂選取區域。在此情況下，選取區域代表整個扁平化。

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_WIDTH = 11500
WIA_IPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

範例 2：應用程式會將WIA_IPS_PAGE_SIZE屬性設定為 WIA_PAGE_LETTER

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

範例 3：應用程式會將WIA_IPS_ORIENTATION屬性設定為 LANDSCAPE

實體台必須能夠取得原本處於橫向方向的頁面。

WIA_IPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_IPS_PAGE_HEIGHT = 11000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

範例 4：應用程式會將WIA_IPS_XEXTENT屬性變更為較小的值

在下列範例中，應用程式會將 WIA_IPS_XEXTENT 屬性變更為 1000。 minidriver 應該假設 WIA_IPS_XEXTENT 中包含的新值不再對 WIA_IPS_PAGE_SIZE 屬性有效，因此應該將 WIA_IPS_PAGE_SIZE 變更為 WIA_PAGE_CUSTOM。迷你驅動程式也必須調整 WIA_IPS_PAGE_WIDTH。

WIA_IPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_IPS_PAGE_HEIGHT = 10000
WIA_IPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANDSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

WIA_IPS_PAGE_HEIGHT
ScannerPicturePageHeight

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含目前選取頁面的千分之一英吋的高度。 minidriver 會建立和維護 WIA_IPS_PAGE_HEIGHT 屬性。應用程式會讀取這個屬性，以判斷正在掃描的頁面實體維度。如果範圍設定與已知頁面大小不同，此屬性會報告頁面的高度，其 WIA_IPS_PAGE_SIZE 屬性設定為 WIA_PAGE_CUSTOM (，這是 WIA_IPS_PAGE_SIZE 屬性的值) 。 WIA_IPS_PAGE_HEIGHT 必須與WIA_IPS_XEXTENT 同步，以圖元為單位報告要掃描的頁面高度。

WIA_CATEGORY_FEEDER專案需要這個屬性。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_PAGE_WIDTH
ScannerPicturePageWidth

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含目前選取頁面的寬度，以千分之一英吋為單位。應用程式會讀取這個屬性，以判斷正在掃描的頁面實體維度。如果範圍設定與已知頁面大小不同，此屬性會報告頁面的寬度，其 WIA_IPS_PAGE_SIZE 屬性設定為WIA_PAGE_CUSTOM。 WIA_IPS_PAGE_WIDTH 必須與要掃描之頁面的寬度以圖元為單位 的 WIA_IPS_XEXTENT值同步。 minidriver 會建立和維護這個屬性。

WIA_CATEGORY_FEEDER專案需要這個屬性。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_PAGES
ScannerPicturePages

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含要從自動檔摘要器取得的目前頁數。 minidriver 會建立和維護這個屬性。

類型： VT_I4;存取：讀取/寫入;有效值： WIA_PROP_RANGE 這是掃描程式可掃描的最大頁數為零。如果掃描器可以持續掃描，此值ALL_PAGES (= 0) 。

應用程式會讀取這個屬性，以判斷檔摘要器的頁面容量。應用程式也會將此屬性設定為要掃描的頁數。

注意：
如果已啟用雙工模式 (WIA_IPS_DOCUMENT_HANDLING_SELECT 設定為 FEEDER |雙工 |ADVANCED_DUPLEX) ， WIA_IPS_PAGES 仍然等於要掃描的頁數。

如果已啟用 DUPLEX，則一張紙張會自動包含兩頁，即使頁面的背面空白也一樣。

將 WIA_IPS_PAGES 設定為 1 會導致掃描器處理頁面的一端。我們建議，如果掃描器無法在雙工模式中只掃描頁面的一端，請將 WIA_PROPERTY_INFO 結構之 Range 成員的 Inc 成員 WIA_IPS_PAGES 值變更為 2。這個值會向應用程式發出訊號，指出應用程式必須要求兩個倍數中的頁面。 ALL_PAGES (= 0) 值表示目前載入檔摘要器 的所有 頁面都會經過掃描。

WIA_IPS_PHOTOMETRIC_INTERP
ScannerPicturePhotometricInterp

包含白色和黑色圖元的目前設定。 minidriver 會建立和維護這個屬性。

應用程式會讀取此值，根據應用程式執行) ，判斷 WHITE 或 BLACK (的值。

啟用或預存專案的所有下載數都需要;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK、WIA_CATEGORY_FINISHED_FILE和WIA_CATEGORY_FILM。不支援WIA_CATEGORY_FOLDER專案。

類型： VT_I4;存取：讀取/寫入;有效值： WIA_PROP_LIST。如果裝置只能設定為單一值，請建立WIA_PROP_LIST類型，並將有效的值放在其中。

下表有兩個與這個屬性有效的常數。

值	定義
WIA_PHOTO_WHITE_0	WHITE 為 0，而 BLACK 為 1。
WIA_PHOTO_WHITE_1	WHITE 為 1，而 BLACK 為 0。

WIA_IPS_PREVIEW
ScannerPicturePreview

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指出裝置的預覽模式。應用程式會將此屬性設定為將裝置置於預覽模式。

WIA_CATEGORY_FLATBED和WIA_CATEGORY_FILM專案需要這個屬性，WIA_CATEGORY_FEEDER專案則為選擇性專案。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

下表具有這個屬性有效的常數。

值	定義
WIA_FINAL_SCAN	應用程式會執行最終掃描。
WIA_PREVIEW_SCAN	應用程式會執行預覽掃描。

WIA_IPS_PREVIEW_TYPE
ScannerPicturePreviewType

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定是否可以在影像預覽期間更新現有的預覽影像 (，以回應WIA_IPA_DATATYPE變更或WIA_IPA_DEPTH屬性) 。

對於支援預覽掃描的所有啟用下載專案而言，這個屬性是選擇性的;也就是說，WIA_PREVIEW_SCAN支援WIA_IPS_PREVIEW。這包括類型WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM的專案。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

下表具有這個屬性有效的常數。

常數	描述
WIA_ADVANCED_PREVIEW	可以更新現有的映射。
WIA_BASIC_PREVIEW	必須執行另一個預覽掃描，因為無法更新現有的映射。

WIA_IPS_ROTATION
ScannerPictureRotation

如果實作，則包含目前的旋轉設定。迷你驅動程式會建立和維護這個屬性。

應用程式會將此屬性設定為通知驅動程式，如果完全) 在驅動程式將影像傳回給應用程式之前旋轉影像，則通知驅動程式有多少 (。

注意：
WIA_IPS_ORIENTATION是指要在掃描器台或饋送器上掃描的檔位置。它是相對於掃描方向的檔方向。 WIA_IPS_ROTATION是指在掃描影像之後套用至影像的旋轉，就在影像傳輸至應用程式之前。

WIA 迷你驅動程式負責在將影像資料傳回應用程式之前輪替影像資料。應用程式負責檢查影像標頭，以查看新旋轉的值。

對於解決目前影像選取區域的旋轉效果有相當多的混淆， (是由 WIA_IPS_XPOS、 WIA_IPS_YPOS、 WIA_IPS_XEXTENT 和 WIA_IPS_YEXTENT 屬性所定義) 。

選取區域 是指實體掃描器平臺上要從中取得影像的選取區域。 WIA_IPS_ROTATION 不會修改選取區域。只有在驅動程式取得適當的選取區域之後，驅動程式才會根據 WIA_IPS_ROTATION 套用逆時針旋轉。 WIA_IPS_ROTATION 會影響輸出影像的維度，因此這些維度必須反映在產生的影像資料標頭中。

所有啟用下載專案的選擇性專案;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST

定義下列旋轉常數。

常數	定義
肖像	驅動程式不會旋轉影像。
橫向	驅動程式會逆時針旋轉影像 90 度。
ROT180	驅動程式會逆時針旋轉影像 180 度。
ROT270	驅動程式會逆時針旋轉影像 270 度。

WIA_IPS_SEGMENTATION
ScannerPictureSegmentation

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定應用程式是否應該使用驅動程式的分割篩選器來進行多重區域掃描。如果WIA_IPS_SEGMENTATION支援使用分割篩選建立子專案，或驅動程式本身為固定畫面格建立子專案，則必須針對WIA_CATEGORY_FLATBED和WIA_CATEGORY_FILM專案實作。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

下表有兩個與此屬性有效的常數。

值	定義
WIA_USE_SEGMENTATION_FILTER	應用程式應該使用分割篩選器進行多重區域掃描。
WIA_DONT_USE_SEGMENTATION_FILTER	驅動程式會建立子專案本身以進行多重區域掃描。這通常是掃描器針對此目的使用固定框架的情況。

注意：
驅動程式可能隨附分割篩選，但仍WIA_IPS_SEGMENTATION設定為WIA_DONT_USE_SEGMENTATION_FILTER其中一個專案 (，例如WIA_CATEGORY_FILM專案) 。如果掃描器使用固定畫面格進行電影掃描，但不適用於從WIA_CATEGORY_FLATBED專案進行一般掃描的情況。

WIA_IPS_SHEET_FEEDER_REGISTRATION
ScannerPictureSheetFeederRegistration

注意：
只有 Windows Vista 和更新版本才支援此屬性。

包含放置於平面上之檔的註冊或對齊和邊緣偵測。迷你驅動程式會建立和維護這個屬性。此屬性指出工作表如何水準定位在手部或紙張送入掃描器的掃描頭上。屬性是用來預測檔在掃描頭上放置的位置。

對於支援多個掃描前端的掃描器，此屬性會相對於最上層的掃描前端。這個屬性是工作表送入、捲動式和便攜掃描器的必要屬性。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

下表有三個常數，這些常數對此屬性有效。

常數	描述
LEFT_JUSTIFIED	工作表位於左側，與掃描頭有關。
中心	工作表以掃描頭為中心。
RIGHT_JUSTIFIED	工作表位於右側，與掃描頭有關。

WIA_IPS_SHOW_PREVIEW_CONTROL
ScannerPictureShowPreviewControl

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指出專案是否需要向使用者顯示的預覽控制項。迷你驅動程式會建立和維護這個屬性。

所有啟用傳輸的專案都是選擇性的。這通常只是類別WIA_ITEM_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FILM和WIA_CATEGORY_FINISHED_FILE的專案。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

下表具有這個屬性有效的常數。

常數	描述
WIA_SHOW_PREVIEW_CONTROL	向使用者顯示預覽控制項，因為此裝置可以執行預覽。
WIA_DONT_SHOW_PREVIEW_CONTROL	請勿向使用者顯示預覽控制項，因為此裝置無法執行預覽。

WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION
ScannerPictureSupportsChildItemCreation

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定應用程式 (或篩選) 是否可以在目前專案下建立子專案。

所有啟用傳輸的專案類別為選擇性：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FILM甚至是WIA_CATEGORY_FOLDER。 (如果儲存體不支援上傳新專案，則此屬性應該不受支援或支援 FALSE 值。)

支援WIA_IPS_SEGMENTATION和WIA_USE_SEGMENTATION_FILTER的專案也必須支援WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION，並將其設定為 TRUE。

類型： VT_I4、Access：唯讀、有效值： TRUE 和 FALSE

WIA_IPS_THRESHOLD
ScannerPictureThreshold

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定灰階值，決定當影像轉換成單色時，圖元是否會轉換成白色或黑色。高於閾值的圖元會變成白色。低於閾值的圖元會變成白色。

需要這個屬性，才能取得支援 1-bpp 掃描且WIA_IPA_DATATYPE屬性設定為 WIA_DATA_THRESHOLD 的專案。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_TRANSFER_CAPABILITIES
ScannerPictureTransferCapabilities

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定驅動程式是否可以在單一轉移呼叫中傳輸多個子專案。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_FLAG

此屬性的唯一可能值是WIA_TRANSFER_CHILDREN_SINGLE_SCAN。如果設定此旗標，則驅動程式能夠在單一傳輸呼叫中傳輸多個子專案。如果未設定旗標，WIA 服務會以遞迴方式逐步執行子專案，然後傳輸每個專案。

WIA_IPA_UPLOAD_ITEM_SIZE
ScannerPictureInvert

注意：
只有 Windows Vista 和更新版本才支援此屬性。

指定要為專案上傳的位元組數目。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_NONE

WIA_IPS_WARM_UP_TIME
ScannerPictureWarmUpTime

指定啟動掃描工作之前裝置所需的最大準備時間，以毫秒為單位。迷你驅動程式會建立和維護這個屬性。

應用程式可以讀取此屬性，以判斷此裝置的準備時間上限。然後，它可以呈現「等候裝置準備」對話方塊，讓使用者知道在發生任何事之前，可能會發生等候或暫停。

所有啟用擷取的專案都需要此屬性;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE

WIA_IPS_XEXTENT
ScannerPictureXextent

包含要取得之所選影像的目前寬度，以圖元為單位。應用程式會將此屬性設定為標示要取得之選取區域的寬度。此屬性必須與 WIA_IPA_PIXELS_PER_LINE 屬性一致。迷你驅動程式會建立和維護這個屬性。

所有啟用下載專案的必要專案;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_XPOS
ScannerPictureXpos

包含所選取影像左上角的 x 座標，以圖元為單位。應用程式會將此屬性設定為標示選取區域的左上角。迷你驅動程式會建立和維護這個屬性。

所有啟用下載專案的必要專案;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK、WIA_CATEGORY_FINISHED_FILE和WIA_CATEGORY_FILM。不支援WIA_CATEGORY_FOLDER專案。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_XRES
ScannerPictureXres

包含裝置目前的水準解析度，以圖元為單位。應用程式會將此屬性設定為設定水準解析度。迷你驅動程式會建立和維護這個屬性。

如果裝置只能設定為單一值，請建立 WIA_PROP_LIST 類型，並將有效的值放在其中。這也是一個解析設定相依于另一個解析度的情況。 (垂直解析度取決於水準解析度。)

類型： VT_I4、Access：讀取/寫入或唯讀、有效值： WIA_PROP_RANGE 或WIA_PROP_LIST

WIA_IPS_XSCALING
ScannerPictureXscaling

注意：
只有 Windows Vista 和更新版本才支援此屬性。

將水準縮放比例設定為百分比，以百分比套用至掃描器裝置或其驅動程式內的掃描影像。

此屬性是所有啟用下載專案的選擇性屬性;也就是說，類型的專案WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

類型： VT_I4、Access：讀取/寫入或唯讀、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE。

值可以從 1 到最大值VT_I4 (0xFFFF) 。例如，100 表示沒有調整，050 表示相應減少為 50% 的 Orignal 大小，而 200 表示相應增加至原始大小的 200%。

WIA_IPS_YEXTENT
ScannerPictureYextent

包含要取得之所選影像的目前高度，以圖元為單位。應用程式會將此屬性設定為標示選取區域的高度。此屬性必須與 WIA_IPA_PIXELS_PER_LINE 屬性的值一致。迷你驅動程式會建立和維護這個屬性。

所有啟用下載專案的必要專案;也就是說，類別中的專案：WIA_CATEGORY_FLATBED、WIA_CATEGORY_FEEDER、WIA_CATEGORY_FEEDER_FRONT、WIA_CATEGORY_FEEDER_BACK和WIA_CATEGORY_FILM。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_YPOS
ScannerPictureYpos

選取影像左上角的目前 Y 座標，以圖元為單位。應用程式會將此屬性設定為標示選取區域的左上角。迷你驅動程式會建立和維護這個屬性。

類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_RANGE

WIA_IPS_YRES
ScannerPictureYres

包含裝置目前的垂直解析度，以圖元為單位。應用程式會將此屬性設定為設定垂直解析度。迷你驅動程式會建立和維護這個屬性。

如果裝置只能設定為單一值，請建立 WIA_PROP_LIST 類型，並將有效的值放在其中。這也是一個解析設定相依于另一個解析度的情況。 (水準解析度取決於垂直解析度。)

類型： VT_I4、Access：讀取/寫入或唯讀、有效值： WIA_PROP_RANGE 或WIA_PROP_LIST

WIA_IPS_YSCALING
ScannerPictureYscaling

注意：
只有 Windows Vista 和更新版本才支援此屬性。

將垂直縮放比例設定為百分比，以百分比套用至掃描器裝置或其驅動程式內的掃描影像。

類型： VT_I4、Access：讀取/寫入或唯讀、有效值： WIA_PROP_LIST 或WIA_PROP_RANGE。

值可以從 1 到最大值VT_I4 (0xFFFF) 。例如，100 表示沒有調整，050 表示相應減少為 50% 的 Orignal 大小，而 200 表示相應增加至原始大小的 200%。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Wiadef.h

共用方式為

掃描器 WIA 專案屬性常數

規格需求

意見反應

其他資源