共用方式為


掃描器裝置屬性常數

Windows 映像擷取 (WIA) 硬體裝置具有儲存在 Windows 登錄中的屬性值。 如需詳細資訊,請參閱 Common Device Property Constants。 下列裝置屬性常數及其相關聯的字串是數位影像掃描器特有的。

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

常數/值 描述
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
注意:
只有 Windows Vista 和更新版本才支援這個屬性。


包含 Web 服務掃描器裝置的唯一函式實例識別碼。 此識別碼代表 WIA 迷你驅動程式正在通訊之掃描器裝置上的 Web 服務。 不應假設此識別碼的格式。 WIA 迷你驅動程式會建立和維護此屬性。
WIA 應用程式可以使用 WIA_DPS_DEVICE_ID 的值,透過函式探索 API 來尋找函式實例物件,此物件代表目前 WIA 2.0 會話中使用的 Web 服務掃描器裝置。
類型: VT_BSTR、Access:唯讀、有效值: WIA_PROP_NONE

WIA_DPS_DITHER_PATTERN_DATA
保留,請勿使用。
類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
保留,請勿使用。
類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
包含掃描器的功能。 minidriver 會建立和維護這個屬性。
應用程式會讀取這個屬性,以判斷掃描器是否已安裝平面、檔摘要器或雙工。 這個屬性也可用來進一步定義已安裝的功能。
類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE
下表描述僅適用于 Windows 7 的常數。
Flags 描述
AUTO_SOURCE 掃描器已安裝自動檔處理常式。

 

下表描述僅適用于 Windows 7 和 Windows Vista 的常數。

Flags 描述
ADVANCED_DUP 裝置支援進階雙工掃描設定。 使用WIA_IPS_DUPLEX_SETTINGS在基本和進階雙工組態之間切換。
DETECT_FILM_TPA 掃描器可以偵測透明度/電影介面卡何時準備好掃描。
DETECT_STOR 掃描器可以在內部儲存體中偵測到是否有檔。
FILM_TPA 掃描器配備透明度/電影掃描配接器。
STOR 掃描器配備內部影像儲存裝置。

 

下表描述 Windows XP 或更新版本有效的常數。

Flags 描述
DETECT_FEED 掃描器可以偵測摘要器中的檔。
DETECT_FLAT 掃描器可以在平面分板上偵測檔。
DETECT_SCAN 掃描器只能藉由掃描來偵測摘要器中的檔。
DUP 掃描器具有雙工。
飼料 掃描器已安裝自動檔處理常式。
掃描器具有平面分板。

 

下表描述僅適用于 Windows XP 的常數。 這些值已被 Windows 7 和 Windows Vista 取代,不應使用。

Flags 描述
DETECT_DUP 掃描器可以從使用者偵測雙工掃描要求。
DETECT_DUP_AVAIL 掃描器可以在安裝雙工器時得知。
DETECT_FEED_AVAIL 掃描器可以在安裝自動檔摘要器時得知。

 

WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

注意:
Windows Vista 和更新版本中不支援此屬性。 使用 WIA_IPS_DOCUMENT_HANDLING_SELECT

 

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

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

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

下表有十個常數,這些常數與這個屬性有效。

Flags 描述
饋線 使用檔摘要器掃描。
平板 使用扁平化掃描。
雙工 使用雙工作業進行掃描。
AUTO_ADVANCE 啟用掃描後自動饋送下一份檔。
FRONT_FIRST 先掃描檔前方。 當設定 DUPLEX 時,這個值是有效的。
BACK_FIRST 先掃描檔背面。 當設定 DUPLEX 時,這個值是有效的。
FRONT_ONLY 僅掃描前端。 當設定 DUPLEX 時,這個值是有效的。
BACK_ONLY 僅掃描上一頁。 當設定 DUPLEX 時,這個值是有效的。
NEXT_PAGE 掃描檔的下一頁。
PREFEED 啟用預先摘要模式。 掃描時,下一份檔的前置位置。

 

WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

包含掃描器已安裝的平面、檔摘要器或雙工工具的目前狀態。 minidriver 會建立和維護這個屬性。

應用程式會讀取這個屬性,以判斷掃描器裝置是否已準備好使用。 這是在取得影像之前,檢查紙張是否在摘要器中的理想方式。

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

下表具有這個屬性有效的常數。星號 * 表示 Windows Vista 或更新版本不支援旗標。 V符號表示旗標僅支援 Windows Vista 和更新版本。

Flags 描述
FEED_READY 扁平化已可供使用。
FLAT_READY 掃描器在平面分板上有檔。
DUP_READY 雙工器已啟用並可供使用。
FLAT_COVER_UP 一般台蓋已啟動。
PATH_COVER_UP 紙張路徑已涵蓋,並防止適當的作業。
PAPER_JAM 檔摘要器中會干擾檔。
FILM_TPA_READYV 透明度配接器已安裝並可供使用。
STORAGE_READYV 內部儲存裝置已就緒。
STORAGE_FULLV 儲存體已滿,無法執行上傳作業。
MULTIPLE_FEEDV 發生多個摘要條件 (通常是PAPER_JAM) 。
DEVICE_ATTENTIONV 需要使用者介入裝置時發生錯誤。
LAMP_ERRV 掃描器因為燈光問題而尚未就緒。

 

WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

包含應用程式可用來建立有效背書者字串的所有有效字元。 背書者是安裝在掃描器上的印表機,會在掃描的每個頁面上列印文字訊息。 minidriver 應該根據此屬性中的有效字元集,驗證 WIA_DPS_ENDORSER_STRING 屬性的設定。 minidriver 會建立和維護這個屬性。

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

WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

包含要以其他方式 (背書的字串,也就是在迷你驅動程式掃描的每個頁面上列印) 。 應用程式會使用在 WIA_DPS_ENDORSER_CHARACTERS 屬性中報告的有效字元集來設定此屬性。 只有在此屬性中設定字串時,minidriver 才應該背書檔。 空字串表示已停用背書者功能。

因為驅動程式負責解譯背書者字串,所以您的驅動程式可以在 WIA_DPS_ENDORSER_STRING中使用特殊字元。 不過,只有您的應用程式會瞭解這些字元。

類型: VT_BSTR、Access:讀取/寫入、有效值: WIA_PROP_NONE

支援 WIA_DPS_ENDORSER_STRING 屬性的驅動程式必須支援下列權杖清單。

Token 描述
$DATE$ YYYY/MM/DD 格式的日期。
$DAY$ 表單 DD 中的日期。
$MONTH$ MM 格式的年份月份。
$PAGE_COUNT$ 已傳輸的頁面數目。
$TIME$ HH:MM:SS 格式的當日時間。
$YEAR$ YYYY 格式的年份。

 

WIA_DPS_FILTER_SELECT

保留,請勿使用。

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

WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

注意:
只有 Windows Vista 和更新版本才支援這個屬性。

 

包含 Web 服務掃描器裝置的 SOAP 位址。 WIA 2.0 迷你驅動程式會建立和維護此屬性。

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

WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

注意:
Windows Vista 和更新版本不支援此屬性。

 

包含放在平面上之檔的註冊或水準對齊方式。 minidriver 會建立和維護這個屬性。

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

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

常數 描述
LEFT_JUSTIFIED 紙張靠左對齊。
中心 紙張置中。
RIGHT_JUSTIFIED 紙張靠右對齊。

 

另請參閱

WIA_DPS_VERTICAL_BED_REGISTRATION

WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_MAX_HORIZONTAL_SIZE

 

指定從目前解析度之平面掃描器分板的水準 (X) 軸掃描的最大寬度,以千分之一英吋為單位。 此屬性也適用于自動檔摘要器,可將工作表移至平面掃描器的分板以進行掃描。 對於具有分板的掃描器而言,這個屬性是必要的。 其他掃描器類型會改為實作 WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE 屬性。

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

WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_MAX_HORIZONTAL_SIZE

 

指定從目前解析度從手部或工作表摘要掃描器在水準 (X) 軸中掃描的最大寬度,以千分之一英吋為單位。 這個屬性也適用于自動檔饋送器,其掃描時不會將工作表移至平面掃描器的分板。 這個屬性是工作表送入、捲動式和手部掃描器的必要屬性。

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

WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

包含使用目前屬性設定掃描單一頁面的最大時間,以毫秒為單位。 應用程式會讀取此屬性,以估計掃描頁面所需的時間。 這在判斷已停止回應之裝置的條件時很有説明。 迷你驅動程式會建立和維護這個屬性。 所有掃描器都需要這個屬性。

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

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_MIN_HORIZONTAL_SIZE

 

包含掃描器檔摘要器可以掃描之最小頁面的實體水準維度,以千分之一英吋為單位。 迷你驅動程式會建立和維護這個屬性。

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

另請參閱

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_MIN_VERTICAL_SIZE

 

包含掃描器檔摘要器可以掃描之最小頁面的實體垂直維度,以千分之一英吋為單位。 迷你驅動程式會建立和維護這個屬性。

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

另請參閱

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE

WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_OPTICAL_XRES

 

水準光學解析度。 DPI 中支援的最高水準光學解析度。 這個屬性是單一值。 這不是裝置可產生之所有解析度的清單。 相反地,這是裝置光學的解析度。 迷你驅動程式會建立和維護這個屬性。 所有掃描器都需要這個屬性。

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

WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_OPTICAL_YRES

 

垂直光學解析度。 DPI 中支援的最高垂直光學解析度。 這個屬性是單一值。 這不是裝置所產生的所有解析度清單。 相反地,這是裝置光學的解析度。 迷你驅動程式會建立和維護這個屬性。 所有掃描器都需要這個屬性。

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

WIA_DPS_ORIENTATION
ScannerDeviceOrientation

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

應用程式會設定 WIA_DPS_ORIENTATION 屬性,以定義要取得之頁面或影像的原始方向。 如需如何使用WIA_DPS_ORIENTATION的詳細資訊,請參閱 WIA_DPS_PAGE_SIZE

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

下表有四個常數,這些常數對此屬性有效。

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

 

另請參閱

WIA_IPS_ROTATION

WIA_DPS_PAD_COLOR
ScannerDevicePadColor

當影像資料不足而無法填滿要求的緩衝區時,用來填補的色彩。 這個屬性是針對填補緩衝區的掃描器所實作。 對於所有掃描器而言,這個屬性是選擇性的。 minidriver 會建立和維護這個屬性。

類型:VT_UI1 | VT_VECTOR、Access:唯讀、有效值:WIA_PROP_NONE

色彩資訊的格式為 RGBQUAD

WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_PAGE_HEIGHT

 

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

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

WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_PAGE_SIZE

 

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

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

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

定義
WIA_PAGE_A4 8267 X 11692 (直向)
WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHTWIA_DPS_PAGE_WIDTH 屬性的值定義
WIA_PAGE_LETTER 8500 X 11000 (PORTRAIT 方向)

 

WIA_IPS_ORIENTATION屬性的值會決定目前選取頁面的方向。 WIA_DPS_PAGE_WIDTHWIA_DPS_PAGE_HEIGHT屬性會以千英吋為單位報告頁面的維度。 請注意,這些屬性必須與 WIA_IPS_XEXTENTWIA_IPS_YEXTENT合約,其中包含以圖元為單位的頁面維度。 WIA_PROP_LIST類型的有效值應該取決於 WIA_IPS_ORIENTATION 屬性的有效設定。 如果裝置無法掃描具有WIA_PAGE_A4設定的橫向檔,當WIA_IPS_ORIENTATION設為 LANSCAPE 時,WIA_PAGE_A4不應該出現在WIA_DPS_PAGE_SIZE屬性的有效值清單中。

如果應用程式將 WIA_DPS_PAGE_SIZE 設定為WIA_PAGE_CUSTOM以外的任何值,迷你驅動程式應該調整 WIA_DPS_PAGE_WIDTH 的值,並將 WIA_DPS_PAGE_HEIGHT 以千英吋為單位的頁面維度。 它也應該將 WIA_IPS_XEXTENT 值和 WIA_IPS_YEXTENT 調整為以圖元為單位的頁面維度。

如果範圍設定 (WIA_IPS_XEXTENTWIA_IPS_YEXTENT) 變更為不符合目前頁面大小設定的值,minidriver 應該將 WIA_DPS_PAGE_SIZE 屬性值變更為 WIA_PAGE_CUSTOM 。 minidriver 也應該根據新的範圍設定修改 WIA_DPS_PAGE_WIDTHWIA_DPS_PAGE_HEIGHT

如果 WIA_IPS_ORIENTATION 設定為 LANSCAPE,範圍設定將會「翻轉」。例如,如果應用程式將 WIA_DPS_PAGE_SIZE 設定為 WIA_PAGE_A4,minidriver 應該將 WIA_DPS_PAGE_WIDTH 設定為 11692, 並將 WIA_DPS_PAGE_HEIGHT 設定 為 8267。 (minidriver 也應該設定 WIA_IPS_XEXTENT 並據以 WIA_IPS_YEXTENT 。) 請注意,如果 WIA_DPS_PAGE_SIZE 設定為 WIA_PAGE_CUSTOM,則方向設定不會用來判斷要掃描的頁面範圍維度。

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

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

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

  1. 驅動程式會報告設定。
  2. 應用程式會將 WIA_DPS_PAGE_SIZE 屬性設定為 WIA_PAGE_LETTER。
  3. 應用程式會將 WIA_IPS_ORIENTATION 屬性設定為 LANSCAPE。
  4. 應用程式會將 WIA_IPS_XEXTENT 屬性變更為較小的值。

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

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

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_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_DPS_PAGE_SIZE屬性設定為 WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_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屬性設定為 LANSCAPE

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

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
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_DPS_PAGE_SIZE 屬性有效,因此應該將 WIA_DPS_PAGE_SIZE 變更為 WIA_PAGE_CUSTOM。 minidriver 也必須調整 WIA_DPS_PAGE_WIDTH

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
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_DPS_PAGE_WIDTH
ScannerDevicePageWidth

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_PAGE_WIDTH

 

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

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

WIA_DPS_PAGES
ScannerDevicePages

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_PAGES

 

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

類型: VT_I4;存取:讀取/寫入;有效值: WIA_PROP_RANGE (零到檔摘要器可以保存的最大頁數)

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

注意:
如果已啟用雙工模式 (WIA_DPS_DOCUMENT_HANDLING_SELECT 設定為 FEEDER |雙工 ) , WIA_DPS_PAGES 仍然等於要掃描的頁數。

 

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

WIA_DPS_PAGES設定 為 1 會導致掃描器處理頁面的其中一側。 建議掃描器在雙工模式中只掃描頁面的一端時, WIA_DPS_PAGES WIA_PROPERTY_INFO 結構之 Inc 成員的有效值應該變更為 2。 這個值會向應用程式發出訊號,指出應用程式必須要求兩個倍數中的頁面。 值為零表示要掃描目前載入檔摘要器 的所有 頁面。

WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

指定要掃描之工作表背面的分色板色彩。 對於具有分板的掃描器而言,這個屬性是選擇性的。 minidriver 會建立和維護這個屬性。

類型:VT_UI1 | VT_VECTOR、Access:唯讀、有效值:WIA_PROP_NONE

色彩資訊的格式為 RGBQUAD

WIA_DPS_PREVIEW
ScannerDevicePreview

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_PREVIEW

 

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

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

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

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

 

WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

包含值,指出掃描器是否會在將頁面傳送至應用程式之前快取掃描器緩衝區中的頁面。

值為零會先停用掃描,而且不會事先掃描任何頁面。 在緩衝掃描前專案上執行一般資料傳輸會擷取緩衝的頁面。 WIA 屬性無法在預先掃描工作期間變更。 這是選用屬性。

類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_RANGE 零到檔摘要器可以保存的最大頁數。

WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

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

 

指出輸入來源 (扁平化、自動檔摘要器或 fil 掃描配接器) 掃描來源,或要從中傳輸資料的儲存位置。

掃描事件會通知應用程式使用者已起始掃描,但事件不提供代表輸入來源的 WIA 專案名稱。 應用程式的事件處理常式可以查詢根專案的WIA_DPS_SCAN_AVAILABLE_ITEM屬性,以取得輸入來源專案的名稱。

類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_RANGE 零到檔摘要器可以保存的最大頁數。

WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

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

 

包含 Web 服務掃描器裝置的服務識別碼。 WIA 2.0 迷你驅動程式會建立和維護此屬性。

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

WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_SHEET_FEEDER_REGISTRATION

 

包含放置於平面的檔註冊或對齊和邊緣偵測。 minidriver 會建立和維護這個屬性。 這個屬性工作表示工作表如何水準放置在掌上或工作表饋送掃描器的掃描頭上。 屬性是用來預測檔在掃描頭上放置的位置。

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

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

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

常數 描述
LEFT_JUSTIFIED 工作表位於左側,與掃描前端有關。
中心 工作表會置中于掃描頭上。
RIGHT_JUSTIFIED 工作表位於右側,與掃描前端有關。

 

WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

注意:
Windows Vista 不支援此屬性。 使用 WIA_IPS_SHOW_PREVIEW_CONTROL

 

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

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

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

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

 

WIA_DPS_USER_NAME
ScannerDeviceUserName

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

 

WIA 服務用來通知迷你驅動程式有關使用者帳戶名稱 (在目前 WIA 應用程式執行所在的會話) 時,包括網路功能變數名稱。

這是 WIA 服務所管理的根專案屬性。

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

WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

注意:
Windows Vista 和更新版本不支援此屬性。

 

包含平面上放置之檔的註冊或垂直對齊和邊緣偵測。 minidriver 會建立和維護這個屬性。

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

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

常數 描述
TOP_JUSTIFIED 紙張靠上對齊。
中心 紙張置中。
BOTTOM_JUSTIFIED 紙張靠下對齊。

 

另請參閱

WIA_DPS_HORIZONTAL_BED_REGISTRATION

WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_MAX_VERTICAL_SIZE

 

指定垂直 (Y) 座標軸中,以千分之一英吋為單位的最大高度,以目前解析度從平面掃描器的分板掃描。 此屬性也適用于自動檔饋送器,可將工作表移至平面掃描器的分頁以進行掃描。 這個屬性是具有分板的掃描器的必要屬性。 其他掃描器類型會改為實作 WIA_DPS_VERTICAL_SHEET_FEED_SIZE 屬性。

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

WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

注意:
Windows Vista 和更新版本不支援此屬性。 使用 WIA_IPS_MAX_VERTICAL_SIZE

 

指定以千分之一英吋為單位的最大高度,以目前解析度在垂直 (Y) 軸上掃描。 這個屬性也適用于自動檔饋送器,這些摘要器不會將工作表移至平面掃描器的分頁。 這個屬性是工作表送出掃描器的必要屬性。 捲動傳送和手部掃描器不應該實作這個屬性。

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

規格需求

需求
最低支援的用戶端
Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
Wiadef.h