WIA 驅動程式服務連結庫
WIA 驅動程式服務連結庫包含 WIA 迷你驅動程式可以呼叫的函式,以取得執行下列工作的協助:
WIA 迷你驅動程式會視需要從其 IWiaMiniDrv 介面 方法呼叫大部分的函式。 不過,每個 WIA 迷你驅動程式都必須在 IWiaMiniDrv::d rvInitializeWia 方法中呼叫 wiasCreateDrvItem 函式,以建立驅動程序專案。 每次成功呼叫 wiasCreateDrvItem 函式時,都會建立 IWiaDrvItem 專案物件,該對象用於迷你驅動程式的專案樹狀結構中。 數 個 IWiaDrvItem 介面 方法具有 IWiaDrvItem 類型的參數,包括 IWiaDrvItem::AddItemToFolder、 IWiaDrvItem::GetFirstChildItem、 IWiaDrvItem::GetNextSiblingItem 和 IWiaDrvItem::GetParentItem。 此外, wiasGetDrvItem 函式具有此類型的參數。
驅動程式服務連結庫提供下列函式。
建置和維護專案樹狀結構
函式 | 描述 |
---|---|
wiasCreateChildAppItem | 建立新的應用程式專案,並將它插入為指定 (父) 專案的子系。 |
wiasCreateDrvItem | 建立 IWiaDrvItem 物件。 |
wiasGetChildrenContexts | 擷取屬於目前專案子系的項目內容陣列。 |
wiasGetContextFromName | 擷取項目名稱的項目內容。 |
wiasGetDrvItem | 擷取驅動程序專案。 |
wiasGetRootItem | 擷取指定 WIA 專案的根項目內容。 |
記錄錯誤和追蹤訊息
函式 | 描述 |
---|---|
wiasCreateLogInstance | 建立記錄對象的實例。 |
wiasDebugError | 在偵錯控制台中列印偵錯錯誤字串 裝置管理員。 輸出色彩一律為紅色。 此函式僅供相容性使用。 建議改用 WIAS_ERROR 。 |
wiasDebugTrace | 在偵錯控制台中列印偵錯追蹤字串 裝置管理員。 此函式僅供相容性使用。 建議改用 WIA_TRACE 。 |
wiasFormatArgs | 將自變數清單格式化為封裝字串以進行記錄。 |
wiasPrintDebugHResult | 在偵錯控制臺上列印 裝置管理員 HRESULT 字串。 此函式僅供相容性使用。 已過時且不再受到支援。 請改用 WIAS_LHRESULT 。 |
讀取和儲存項目屬性
函式 | 描述 |
---|---|
wiasCreatePropContext | 配置屬性內容,以指出項目的屬性正在變更。 |
wiasFreePropContext | 釋放 WIA_PROPERTY_CONTEXT 結構所佔用的記憶體。 |
wiasGetChangedValueFloat | 判斷應用程式是否已變更具有浮點值的屬性。 |
wiasGetChangedValueGuid | 判斷具有 GUID 值的屬性是否已由應用程式變更。 |
wiasGetChangedValueLong | 判斷應用程式是否已變更具有長整數值的屬性。 |
wiasGetChangedValueStr | 判斷應用程式是否已變更具有字串值的屬性。 |
wiasGetItemType | 表示根或子專案。 |
wiasGetPropertyAttributes | 擷取一組屬性的存取旗標和有效值。 |
wiasIsPropChanged | 測試應用程式是否已變更指定的屬性。 |
wiasReadMultiple | 從 WIA 專案讀取多個屬性。 |
wiasReadPropBin | 從 WIA 專案讀取單一二進位屬性。 |
wiasReadPropFloat | 從 WIA 專案擷取浮點屬性值。 |
wiasReadPropGuid | 從 WIA 專案擷取 GUID 屬性值。 |
wiasReadPropLong | 從 WIA 專案擷取長整數屬性值。 |
wiasReadPropStr | 從 WIA 專案擷取字串屬性值。 |
wiasSetItemPropAttribs | 設定項目屬性集的存取旗標和有效值。 |
wiasSetItemPropNames | 將屬性名稱寫入項目屬性。 |
wiasSetPropChanged | 修改屬性內容,以指出正在變更屬性。 |
wiasSetPropertyAttributes | 設定項目屬性的存取旗標和屬性值。 |
wiasSetValidFlag | 設定WIA_PROP_FLAG屬性的有效值。 |
wiasSetValidListFloat | 設定子VT_R4類型之WIA_PROP_LIST屬性的有效值。 |
wiasSetValidListGuid | 設定子類型VT_CLSID WIA_PROP_LIST屬性的有效值。 |
wiasSetValidListLong | 設定子VT_I4類型之WIA_PROP_LIST屬性的有效值。 |
wiasSetValidListStr | 設定子VT_BSTR類型之WIA_PROP_LIST屬性的有效值。 |
wiasSetValidRangeFloat | 指定子類型VT_R4 WIA_PROP_RANGE屬性的有效值範圍。 |
wiasSetValidRangeLong | 指定子類型VT_I4 WIA_PROP_RANGE屬性的有效值範圍。 |
wiasUpdateValidFormat | 匯報 目前迷你驅動程序的屬性內容有效格式。 |
wiasValidateItemProperties | 根據目前的有效值,驗證簡單專案屬性的清單。 |
wiasWriteMultiple | 將多個屬性值寫入 WIA 專案, (屬性可能是不同類型的) 。 |
wiasWritePropBin | 將單一二進位屬性值寫入 WIA 專案。 |
wiasWritePropFloat | 將浮點屬性值寫入 WIA 專案。 |
wiasWritePropGuid | 將 GUID 屬性值寫入 WIA 專案。 |
wiasWritePropLong | 將長整數屬性值寫入 WIA 專案。 |
wiasWritePropStr | 將字串屬性值寫入 WIA 專案。 |
更新和傳輸數據
函式 | 描述 |
---|---|
wiasDownSampleBuffer | 接受像素數據的緩衝區,並將它向下取樣到指定的大小。 |
wiasGetImageInformation | 從專案擷取傳輸內容資訊。 |
wiasParseEndorserString | 剖析背書者字串,並將字串中 WIA 服務定義和廠商定義的令牌取代為與令牌相關聯的值。 |
wiasSendEndOfPage | 在數據傳輸期間呼叫用戶端回呼例程,並傳送目前的總頁面計數。 |
wiasUpdateScanRect | 匯報 掃描裝置的掃描區域大小。 |
wiasWriteBufToFile | 將暫存頁面緩衝區的內容寫入圖像檔案。 |
wiasWritePageBufToFile | 將暫存頁面緩衝區的內容寫入圖像檔案。 使用此函式將頁面寫入多頁 TIFF 檔案。 |