通用 WIA 專案屬性常數
除非另有說明，否則所有 IWiaItem、 IWiaItem2 和 IWiaDrvItem 介面 介面都必須支援下列裝置屬性常數。
前置詞 「WIA_IPA_」 表示所有裝置的專案屬性，而且是 C/C++ 中使用的命名慣例。 針對腳本用途，這些常數會使用前置詞 「Picture」，而且是 WiaItemPropertyId 列舉類型的一部分。 來自該腳本列舉的對應成員名稱會出現在下列清單中的 C/C++ 常數名稱旁的括弧中。
| 常數/值 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
此旗標可控制專案的存取權，以及是否刪除專案。 所有 WIA 2.0 專案都需要。 類型： VT_I4;讀取/寫入或唯讀，取決於專案擁有其存取權限變更的能力;有效值：WIA_PROP_FLAG 下表有五個旗標，這些旗標在此屬性中有效。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
這個屬性是保留供未來使用，目前不會實作。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含映射每個通道的位數。 迷你驅動程式會建立和維護這個屬性。 所有已啟用 WIA 2.0 擷取或預存映射專案的必要專案。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含資料傳輸期間所使用的緩衝區大小，以位元組為單位。 迷你驅動程式會建立和維護這個屬性。 應用程式可以讀取此屬性，以判斷資料傳輸的驅動程式指定的緩衝區大小。 WIA 服務也會讀取此屬性，以在資料傳輸期間為迷你驅動程式配置記憶體 所有啟用傳輸功能的 WIA 2.0 專案都是選擇性的。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE
注意： |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含影像一行掃描中的位元組數目。 迷你驅動程式會建立和維護這個屬性。 所有 WIA 2.0 專案的選擇性專案。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含影像每個圖元的通道數目。 迷你驅動程式會建立和維護這個屬性。 所有已啟用 WIA 2.0 擷取或預存映射專案的必要專案。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
這個屬性是保留供未來使用，目前不會實作。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含目前使用的壓縮類型。 迷你驅動程式會建立和維護這個屬性。 應用程式會讀取此屬性來判斷影像壓縮類型，或設定此屬性以設定壓縮設定。 類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 下表具有這個屬性有效的常數。 V符號表示只有在 Windows Vista 和更新版本中才支援常數。 (它只能透過 IWiaItem2 interface.)
[注意] 當此屬性為WIA_COMPRESSION_NONE，且WIA_IPA_FORMAT為WiaImgFmt_PDFA或WiaImgFmt_XPS時;然後WIA_COMPRESSION_NONE表示壓縮模式未定義，而且掃描器必須決定模式。 WIA_COMPRESSION_AUTO是針對 WIA_IPA_COMPRESSION 屬性定義的新屬性值。 此值適用于所有可程式化影像資料來源專案，包括 Flatbed 和 Feeder。 WIA 迷你驅動程式支援此值時，WIA 應用程式用戶端可以設定WIA_IPA_COMPRESSION，以便在裝置上啟用自動壓縮模式偵測。 WIA_COMPRESSION_AUTO可以使用 ，而不需支援或啟用完整自動色彩， (WIA_DATA_AUTO 和WIA_DEPTH_AUTO) 。 WIA_COMPRESSION_AUTO最適用于支援多個資料類型和位深度的傳輸檔案格式，例如WiaImgFmt_RAW。 如需傳輸檔案格式的詳細資訊，請參閱此表格中的WIA_IPA_FORMAT。 WIA 迷你驅動程式可支援WIA_COMPRESSION_AUTO。 支援時，WIA 迷你驅動程式絕對不能將其設定為WIA_IPA_COMPRESSION的預設值;只有 WIA 應用程式可以設定此值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含裝置目前的資料類型設定。 迷你驅動程式會建立和維護這個屬性。 應用程式會讀取此屬性，以判斷影像的資料類型。 應用程式會寫入此屬性，以設定即將傳輸之影像的目前資料類型。 所有 WIA 2.0 專案都需要這個屬性。 所有已啟用 WIA 2.0 下載的專案和 WIA 2.0 儲存專案的唯讀都必須是可讀寫的。 類型： VT_I4;Windows Vista 作業系統的存取權：此屬性是相機的唯讀，掃描器的讀取/寫入;Windows Vista 和更新版本的存取：此屬性為唯讀，適用于WIA_CATEGORY_FOLDER和WIA_CATEGORY_FINISHED_FILE專案，以及所有其他 WIA 2.0 專案類別的讀取/寫入;有效值： WIA_PROP_LIST 下表具有六個常數，當 WIA_IPA_FORMAT 未設定為 WiaImgFmt_RAW 時，會有效。
WIA_IPA_DATATYPE屬性也用來描述應用程式設定WiaImgFmt_RAW時要使用的 RAW 資料傳輸類型。 驅動程式應該將 WIA_IPA_DATATYPE 屬性設定為允許的值清單，讓應用程式可以從中挑選一個值。 如果裝置只能設定為單一值，請建立 WIA_PROP_LIST 類型，並將有效的值放在其中。 檢查 WIA_IPA_DEPTH 屬性以判斷位深度。 此屬性通常包含相機的單一值。 下表列出當WIA_IPA_FORMAT 設為 WiaImgFmt_RAW時，與WIA_IPA_DATATYPE有效的常數。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH 包含影像的位深度設定。 迷你驅動程式會建立和維護這個屬性。應用程式會讀取此屬性，以判斷影像的位深度設定。 應用程式也可以將此值設定為所需的位深度。 如果裝置只能設定為單一值，請建立 WIA_PROP_LIST 類型，並將有效的值放在其中。 所有 WIA 2.0 專案都需要這個屬性。 所有已啟用 WIA 2.0 下載的專案和 WIA 2.0 儲存專案的唯讀都必須是可讀寫的。 類型： VT_I4;Windows Vista 前作業系統的存取權：可讀寫的;Windows Vista 和更新版本的存取：此屬性為唯讀，適用于WIA_CATEGORY_FOLDER和WIA_CATEGORY_FINISHED_FILE專案，以及所有其他 WIA 2.0 專案類別的讀取/寫入;有效值： WIA_PROP_LIST WIA_DEPTH_AUTO會定義為每個圖元 0 位，而且它是針對WIA_IPA_DEPTH定義的新屬性值。 此值適用于所有可程式化影像資料來源專案，包括 Flatbed 和 Feeder。 WIA 迷你驅動程式支援WIA_DEPTH_AUTO時，WIA 應用程式用戶端可以將WIA_IPA_DEPTH設定為此值，以在裝置上啟用自動色彩偵測。 設定WIA_DEPTH_AUTO時，如果裝置支援自動色彩) ，WIA 迷你驅動程式必須在相同的專案上更新WIA_IPA_DATATYPE，以WIA_DATA_AUTO (必須是支援的值。 WIA_DEPTH_AUTO是選擇性值，但在WIA_IPA_DATATYPE支援WIA_DATA_AUTO時會變成必要值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含特定檔案格式的副檔名。 minidriver 會建立和維護這個屬性。 所有已啟用傳輸功能的 WIA 2.0 專案的選擇性專案。 類型： VT_BSTR、Access：唯讀、有效值： WIA_PROP_NONE 驅動程式會更新這個屬性，以反映 WIA_IPA_FORMAT 屬性的目前值。 例如，如果 WIA_IPA_FORMAT WiaImgFmt_JPEG， 則WIA_IPA_FILENAME_EXTENSION 應該是 jpg。 如果 WIA_IPA_FORMAT WiaImgFmt_BMP，則WIA_IPA_FILENAME_EXTENSION應該是 BMP。
注意： 對於支援標準格式的驅動程式，建議使用這個屬性，而且是實作自訂定義格式的驅動程式的必要屬性。 它會通知應用程式在傳輸私用格式檔案期間要使用的正確副檔名。 例如，如果 A. Datum Corporation 建立了以新格式傳輸檔案的 WIA 驅動程式，公司可以指定 「adc」 的副檔名。 這可讓應用程式將該格式的資料傳輸到檔案，並建立 myfile.adc之類的檔案名，這對了解新副檔名的其他人很有用。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含即將傳輸之影像的目前格式。 應用程式會讀取這個屬性，以判斷其即將接收的影像格式。 應用程式會寫入這個屬性來設定格式。 此屬性取決於 WIA_IPA_TYMED 屬性。 minidriver 會建立和維護這個屬性。 如果裝置只能設定為單一值，請建立 WIA_PROP_LIST 類型，並將有效的值放在其中。 類型： CLSID、Access：讀取/寫入、有效值： WIA_PROP_LIST 下表列出這個屬性有效的常數。 星號 * 表示 Windows Vista 不支援常數。 (它只能透過 IWiaItem 介面。) 雙星號 ** 表示 Windows Server 2003 或 Windows Vista 不支援常數。 V符號表示只有在 Windows Vista 和更新版本中才支援常數。 (它只能透過 IWiaItem2 interface.)
注意： |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含專案名稱 (完整專案名稱，以及路徑資訊) 。 完整專案名稱與wiasCreateDrvItem服務公用程式函式的bstrFullItemName參數相同。 應用程式會讀取此屬性，以判斷它目前使用的專案，以及該專案位於專案樹狀目錄中的位置。 每個專案都應該有唯一的名稱。 應用程式通常會使用完整專案名稱來搜尋專案樹狀結構中的專案。 WIA 服務會建立和維護此屬性。 所有 WIA 2.0 專案都需要。 類型： VT_BSTR、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此屬性保留供日後使用，目前不會實作。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含正確解碼映射所需的 ICM 設定檔名稱。 應用程式會讀取此屬性，以判斷處理影像時要使用的 ICM 設定檔。 WIA 服務會根據驅動程式安裝檔案中的 ICMProfiles 專案來建立和維護此屬性。 類型： VT_BSTR、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
僅支援 Windows Vista 和更新版本。 WIA 2.0 專案會分組成類別，以定義 如何處理或使用 IWiaItem2 。 例如，如果專案代表摘要器，則應用程式應該預期它包含必要的檔摘要器屬性，並像檔摘要器一樣運作。 如果專案代表已完成的檔案，則 WIA 2.0 應用程式應該以這種方式處理，假設資料是靜態且位於裝置上。 (每個專案的規則將會在其個別規格檔中定義。) 所有 WIA 2.0 專案都需要。 類型： VT_CLSID、Access：唯讀、有效值： 專案類別 GUID |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含 WIA 專案的描述性旗標。 專案旗標與wiasCreateDrvItem服務公用程式函式之lObjectFlags參數中的旗標相同。 WIA 服務會建立和維護此屬性。 應用程式會讀取此屬性，以判斷專案的描述性旗標值。 類型： VT_I4 Access：唯讀、有效值： WIA_PROP_NONE 下表具有這個屬性有效的旗標。 星號 * 表示 Windows Vista 或更新版本不支援旗標。 (它只能透過 IWiaItem 介面使用。) 雙星號 ** 表示 Windows Server 2003 或 Windows Vista 或更新版本不支援旗標。 V符號表示旗標僅支援 Windows Vista 和更新版本。 (它只能透過 IWiaItem2 interface.)
根據專案的類別，這些旗標是 WIA 2.0 專案的必要或選擇性，如下表所示。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含專案名稱。 應用程式會讀取這個屬性，以判斷它目前使用的專案。 每個專案都有唯一的名稱。 WIA 服務會建立和維護此屬性。 所有 WIA 2.0 專案都需要。 類型： VT_BSTR、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含與專案相關聯之資料的目前大小，以位元組為單位。 minidriver 會建立和維護這個屬性。 包含是正在傳輸的資料大小總計。 如果此值為零，表示迷你驅動程式沒有有關資料確切大小的資訊。 (這很常見。) 應用程式會讀取此值，以在進行之前判斷取得的大小。 WIA 服務會讀取此屬性，以協助配置記憶體以進行資料傳輸。 如需詳細資訊，請參閱 將資料傳送至 WIA 應用程式 ，如果 屬性設定為零，且 TYMED 已設定為檔案傳輸，WIA 服務不會為 WIA 迷你驅動程式配置任何記憶體。 所有已啟用傳輸功能的 WIA 2.0 專案都需要。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含最初擷取映射的時間。 minidriver 會建立和維護這個屬性。 此屬性應該以 SYSTEMTIME 結構的形式回報為八個 WORD 值的向量， (平臺 SDK 檔) 中所述。 所有 WIA 2.0 專案的選擇性專案。 類型：VT_UI2 | VT_VECTOR Access：讀取/寫入或唯讀、有效值：WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
僅支援 Windows Vista 和更新版本。 指定儲存在WIA_CATEGORY_FOLDER專案中的專案數目。 類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
指定資料傳輸中使用的最小緩衝區大小。 如果資料傳輸是透過回呼機制執行，屬性值可以小於 64KB。 不過，如果傳輸是傳送至檔案，屬性值就是一次傳輸一頁數據所需的位元組數目。 minidriver 會建立和維護此 WIA 屬性。 所有已啟用傳輸功能的 WIA 2.0 專案的選擇性專案。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含影像中包含的行數， (以圖元為單位的影像垂直高度) 。 minidriver 會建立和維護這個屬性。 所有 WIA 2.0 專案的選擇性專案。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含影像每一行中的圖元數， (以圖元為單位的影像寬度) 。 minidriver 會建立和維護這個屬性。 所有 WIA 2.0 專案的選擇性專案。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Windows Vista 和更新版本中不支援此屬性。 包含影像資料封裝選項。 minidriver 會建立和維護這個屬性。 應用程式會讀取這個屬性，以判斷影像封裝選項或設定目前的影像封裝選項。 類型： VT_I4;存取：讀取/寫入;有效值： WIA_PROP_LIST。 如果裝置只能設定為單一值，請建立WIA_PROP_LIST類型，並將有效的值放在其中。 下表有兩個與這個屬性有效的常數。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
包含這個迷你驅動程式所傳輸之影像的慣用格式。 minidriver 會建立和維護這個屬性。 所有已啟用傳輸功能的 WIA 2.0 專案都需要。 類型： CLSID、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
指定代表一組裝置屬性值的 CLSID。 如果設備磁碟機實作這項功能，應用程式會使用這個屬性來判斷裝置是否支援一組值。 類型： CLSID、Access：唯讀、有效值： WIA_PROP_LIST 下表具有 12 個常數，這些常數在此屬性中有效。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
僅支援 Windows Vista 和更新版本。 包含每個通道中的位數目。 此屬性應該回報為通道數目的向量，其中第一個 BYTE 對應至第一個通道中的位數、第二個位元組到第二個通道中的位數等等。 根據WIA_IPA_CHANNELS_PER_PIXEL，需要有數目的通道數目。 當應用程式切換到 WiaImgFmt_RAW 時，驅動程式會設定該屬性。 對於已知的子類型，WIA_IPA_RAW_SUBTYPE下資料表中所列的專案數目也一樣多。 類型：VT_UI1|VT_VECTOR、Access：唯讀、有效值：WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
此屬性保留供日後使用，目前不會實作。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
指定是否要隱藏裝置上專案的一般屬性頁。 這個屬性可在 Windows XP 和更新版本上使用。 類型： VT_I4、Access：唯讀、有效值： WIA_PROP_NONE 下表具有這個屬性有效的常數。 星號 * 表示常數對 Windows Vista 和更新版本無效。 (它只能透過 IWiaItem 介面.)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
這個屬性包含傳送方法設定。 minidriver 會建立和維護這個屬性。 應用程式會讀取這個屬性，以判斷迷你驅動程式的資料傳輸方法。 所有已啟用傳輸功能的 WIA 2.0 專案都需要。 類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_LIST 下表具有這個屬性有效的常數。 星號 * 表示 Windows Vista 和更新版本不正確常數。 (它們只能透過 IWiaItem 介面取得。)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
僅支援 Windows Vista 和更新版本。 指定要針對專案上傳的位元組數目。 類型： VT_I4、Access：讀取/寫入、有效值： WIA_PROP_NONE |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 |
|