掃描器裝置屬性常數
Windows 映像擷取 (WIA) 硬體裝置具有儲存在 Windows 登錄中的屬性值。 如需詳細資訊,請參閱 Common Device Property Constants。 下列裝置屬性常數及其相關聯的字串是數位影像掃描器特有的。
前置詞 「WIA_DPS_」 表示掃描器裝置的裝置屬性,而且是 C/C++ 中使用的命名慣例。 為了編寫腳本目的,這些常數會使用前置詞 「ScannerDevice」,而且是 WiaItemPropertyId 列舉類型的一部分。 來自該腳本列舉的對應成員名稱會出現在下列清單中的 C/C++ 常數名稱旁的括弧中。
常數/值 | 描述 | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
注意: 只有 Windows Vista 和更新版本才支援這個屬性。
|
||||||||||||||||||||||||||||||||||||||
|
保留,請勿使用。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
保留,請勿使用。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
包含掃描器的功能。 minidriver 會建立和維護這個屬性。 應用程式會讀取這個屬性,以判斷掃描器是否已安裝平面、檔摘要器或雙工。 這個屬性也可用來進一步定義已安裝的功能。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 下表描述僅適用于 Windows 7 的常數。
下表描述僅適用于 Windows 7 和 Windows Vista 的常數。
下表描述 Windows XP 或更新版本有效的常數。
下表描述僅適用于 Windows XP 的常數。 這些值已被 Windows 7 和 Windows Vista 取代,不應使用。
|
||||||||||||||||||||||||||||||||||||||
|
注意: 包含目前的掃描器取得來源和模式。minidriver 會建立和維護這個屬性。 應用程式會讀取這個屬性,以判斷掃描器目前的取得來源,或寫入這個屬性來設定掃描器的來源和模式。 此外,應用程式會使用這個屬性來啟用和停用雙工功能。 類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_FLAG 下表有十個常數,這些常數與這個屬性有效。
|
||||||||||||||||||||||||||||||||||||||
|
包含掃描器已安裝的平面、檔摘要器或雙工工具的目前狀態。 minidriver 會建立和維護這個屬性。 應用程式會讀取這個屬性,以判斷掃描器裝置是否已準備好使用。 這是在取得影像之前,檢查紙張是否在摘要器中的理想方式。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 下表具有這個屬性有效的常數。星號 * 表示 Windows Vista 或更新版本不支援旗標。 V符號表示旗標僅支援 Windows Vista 和更新版本。
|
||||||||||||||||||||||||||||||||||||||
|
包含應用程式可用來建立有效背書者字串的所有有效字元。 背書者是安裝在掃描器上的印表機,會在掃描的每個頁面上列印文字訊息。 minidriver 應該根據此屬性中的有效字元集,驗證 WIA_DPS_ENDORSER_STRING 屬性的設定。 minidriver 會建立和維護這個屬性。 類型: VT_BSTR、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
包含要以其他方式 (背書的字串,也就是在迷你驅動程式掃描的每個頁面上列印) 。 應用程式會使用在 WIA_DPS_ENDORSER_CHARACTERS 屬性中報告的有效字元集來設定此屬性。 只有在此屬性中設定字串時,minidriver 才應該背書檔。 空字串表示已停用背書者功能。 因為驅動程式負責解譯背書者字串,所以您的驅動程式可以在 WIA_DPS_ENDORSER_STRING中使用特殊字元。 不過,只有您的應用程式會瞭解這些字元。 類型: VT_BSTR、Access:讀取/寫入、有效值: WIA_PROP_NONE 支援 WIA_DPS_ENDORSER_STRING 屬性的驅動程式必須支援下列權杖清單。
|
||||||||||||||||||||||||||||||||||||||
|
保留,請勿使用。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含 Web 服務掃描器裝置的 SOAP 位址。 WIA 2.0 迷你驅動程式會建立和維護此屬性。 類型: VT_BSTR、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含放在平面上之檔的註冊或水準對齊方式。 minidriver 會建立和維護這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 下表具有這個屬性有效的三個常數。
另請參閱 WIA_DPS_VERTICAL_BED_REGISTRATION |
||||||||||||||||||||||||||||||||||||||
|
注意: 指定從目前解析度之平面掃描器分板的水準 (X) 軸掃描的最大寬度,以千分之一英吋為單位。 此屬性也適用于自動檔摘要器,可將工作表移至平面掃描器的分板以進行掃描。 對於具有分板的掃描器而言,這個屬性是必要的。 其他掃描器類型會改為實作 WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE 屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 指定從目前解析度從手部或工作表摘要掃描器在水準 (X) 軸中掃描的最大寬度,以千分之一英吋為單位。 這個屬性也適用于自動檔饋送器,其掃描時不會將工作表移至平面掃描器的分板。 這個屬性是工作表送入、捲動式和手部掃描器的必要屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
包含使用目前屬性設定掃描單一頁面的最大時間,以毫秒為單位。 應用程式會讀取此屬性,以估計掃描頁面所需的時間。 這在判斷已停止回應之裝置的條件時很有説明。 迷你驅動程式會建立和維護這個屬性。 所有掃描器都需要這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含掃描器檔摘要器可以掃描之最小頁面的實體水準維度,以千分之一英吋為單位。 迷你驅動程式會建立和維護這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 另請參閱 WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含掃描器檔摘要器可以掃描之最小頁面的實體垂直維度,以千分之一英吋為單位。 迷你驅動程式會建立和維護這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 另請參閱 WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE |
||||||||||||||||||||||||||||||||||||||
|
注意: 水準光學解析度。 DPI 中支援的最高水準光學解析度。 這個屬性是單一值。 這不是裝置可產生之所有解析度的清單。 相反地,這是裝置光學的解析度。 迷你驅動程式會建立和維護這個屬性。 所有掃描器都需要這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 垂直光學解析度。 DPI 中支援的最高垂直光學解析度。 這個屬性是單一值。 這不是裝置所產生的所有解析度清單。 相反地,這是裝置光學的解析度。 迷你驅動程式會建立和維護這個屬性。 所有掃描器都需要這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
包含目前的方向設定。迷你驅動程式會建立和維護這個屬性。 應用程式會設定 WIA_DPS_ORIENTATION 屬性,以定義要取得之頁面或影像的原始方向。 如需如何使用WIA_DPS_ORIENTATION的詳細資訊,請參閱 WIA_DPS_PAGE_SIZE 類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_LIST 下表有四個常數,這些常數對此屬性有效。
另請參閱 |
||||||||||||||||||||||||||||||||||||||
|
當影像資料不足而無法填滿要求的緩衝區時,用來填補的色彩。 這個屬性是針對填補緩衝區的掃描器所實作。 對於所有掃描器而言,這個屬性是選擇性的。 minidriver 會建立和維護這個屬性。 類型:VT_UI1 | VT_VECTOR、Access:唯讀、有效值:WIA_PROP_NONE 色彩資訊的格式為 RGBQUAD。 |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含目前選取頁面的千分之一英吋的高度。 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 |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含目前選取要掃描的頁面大小。 若要選取要掃描的頁面維度,應用程式會設定此屬性。 minidriver 會建立和維護這個屬性。 類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_LIST 下表具有這個屬性有效的三個常數。
WIA_IPS_ORIENTATION屬性的值會決定目前選取頁面的方向。 WIA_DPS_PAGE_WIDTH和WIA_DPS_PAGE_HEIGHT屬性會以千英吋為單位報告頁面的維度。 請注意,這些屬性必須與 WIA_IPS_XEXTENT 和 WIA_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_XEXTENT 或 WIA_IPS_YEXTENT) 變更為不符合目前頁面大小設定的值,minidriver 應該將 WIA_DPS_PAGE_SIZE 屬性值變更為 WIA_PAGE_CUSTOM 。 minidriver 也應該根據新的範圍設定修改 WIA_DPS_PAGE_WIDTH 或 WIA_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_SIZE 和 WIA_IPS_ORIENTATION 屬性,而且在結合套用時無效,minidriver 應該傳回 IWiaMiniDrv::d rvValidateItemProperties中的錯誤,讓應用程式設定失敗。 . 下列四個範例顯示不同的 WIA_DPS_PAGE_SIZE 案例。
範例 1:迷你驅動程式會報告設定 在下列範例中,minidriver 會在應用程式設定任何 WIA 屬性之前設定自訂選取區域。 在此情況下,選取區域代表整個扁平化。
範例 2:應用程式會將WIA_DPS_PAGE_SIZE屬性設定為 WIA_PAGE_LETTER
範例 3:應用程式會將WIA_IPS_ORIENTATION屬性設定為 LANSCAPE 實體台必須能夠取得原本處於橫向方向的頁面。
範例 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_WIDTH 必須與 WIA_IPS_XEXTENT的值同步,以圖元為單位報告要掃描的頁面寬度。 minidriver 會建立和維護這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含要從自動檔摘要器取得的目前頁數。 minidriver 會建立和維護這個屬性。 類型: VT_I4;存取:讀取/寫入;有效值: WIA_PROP_RANGE (零到檔摘要器可以保存的最大頁數) 應用程式會讀取這個屬性,以判斷檔摘要器的頁面容量。 應用程式也會將此屬性設定為要掃描的頁數。
注意: 如果已啟用 DUPLEX,則一張紙張會自動包含兩頁,即使頁面的背面空白也一樣。 將 WIA_DPS_PAGES設定 為 1 會導致掃描器處理頁面的其中一側。 建議掃描器在雙工模式中只掃描頁面的一端時, WIA_DPS_PAGES WIA_PROPERTY_INFO 結構之 Inc 成員的有效值應該變更為 2。 這個值會向應用程式發出訊號,指出應用程式必須要求兩個倍數中的頁面。 值為零表示要掃描目前載入檔摘要器 的所有 頁面。 |
||||||||||||||||||||||||||||||||||||||
|
指定要掃描之工作表背面的分色板色彩。 對於具有分板的掃描器而言,這個屬性是選擇性的。 minidriver 會建立和維護這個屬性。 類型:VT_UI1 | VT_VECTOR、Access:唯讀、有效值:WIA_PROP_NONE 色彩資訊的格式為 RGBQUAD。 |
||||||||||||||||||||||||||||||||||||||
|
注意: 指出裝置的預覽模式。 應用程式會將此屬性設定為將裝置置於預覽模式。 類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_LIST 下表有兩個與這個屬性有效的常數。
|
||||||||||||||||||||||||||||||||||||||
|
包含值,指出掃描器是否會在將頁面傳送至應用程式之前快取掃描器緩衝區中的頁面。 值為零會先停用掃描,而且不會事先掃描任何頁面。 在緩衝掃描前專案上執行一般資料傳輸會擷取緩衝的頁面。 WIA 屬性無法在預先掃描工作期間變更。 這是選用屬性。 類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_RANGE 零到檔摘要器可以保存的最大頁數。 |
||||||||||||||||||||||||||||||||||||||
|
注意: 指出輸入來源 (扁平化、自動檔摘要器或 fil 掃描配接器) 掃描來源,或要從中傳輸資料的儲存位置。 掃描事件會通知應用程式使用者已起始掃描,但事件不提供代表輸入來源的 WIA 專案名稱。 應用程式的事件處理常式可以查詢根專案的WIA_DPS_SCAN_AVAILABLE_ITEM屬性,以取得輸入來源專案的名稱。 類型: VT_I4、Access:讀取/寫入、有效值: WIA_PROP_RANGE 零到檔摘要器可以保存的最大頁數。 |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含 Web 服務掃描器裝置的服務識別碼。 WIA 2.0 迷你驅動程式會建立和維護此屬性。 類型: VT_BSTR、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含放置於平面的檔註冊或對齊和邊緣偵測。 minidriver 會建立和維護這個屬性。 這個屬性工作表示工作表如何水準放置在掌上或工作表饋送掃描器的掃描頭上。 屬性是用來預測檔在掃描頭上放置的位置。 對於支援多個掃描頭部的掃描器,此屬性相對於最上層的掃描前端。 這個屬性是工作表送入、捲動和便攜掃描器的必要屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 下表具有這個屬性有效的三個常數。
|
||||||||||||||||||||||||||||||||||||||
|
注意: 指出專案是否需要向使用者顯示的預覽控制項。 minidriver 會建立和維護這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 下表有兩個與這個屬性有效的常數。
|
||||||||||||||||||||||||||||||||||||||
|
注意: WIA 服務用來通知迷你驅動程式有關使用者帳戶名稱 (在目前 WIA 應用程式執行所在的會話) 時,包括網路功能變數名稱。 這是 WIA 服務所管理的根專案屬性。 類型: VT_BSTR、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 包含平面上放置之檔的註冊或垂直對齊和邊緣偵測。 minidriver 會建立和維護這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE 下表具有這個屬性有效的三個常數。
另請參閱。 WIA_DPS_HORIZONTAL_BED_REGISTRATION |
||||||||||||||||||||||||||||||||||||||
|
注意: 指定垂直 (Y) 座標軸中,以千分之一英吋為單位的最大高度,以目前解析度從平面掃描器的分板掃描。 此屬性也適用于自動檔饋送器,可將工作表移至平面掃描器的分頁以進行掃描。 這個屬性是具有分板的掃描器的必要屬性。 其他掃描器類型會改為實作 WIA_DPS_VERTICAL_SHEET_FEED_SIZE 屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||
|
注意: 指定以千分之一英吋為單位的最大高度,以目前解析度在垂直 (Y) 軸上掃描。 這個屬性也適用于自動檔饋送器,這些摘要器不會將工作表移至平面掃描器的分頁。 這個屬性是工作表送出掃描器的必要屬性。 捲動傳送和手部掃描器不應該實作這個屬性。 類型: VT_I4、Access:唯讀、有效值: WIA_PROP_NONE |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 專業版、Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
標頭 |
|