WIA ドライバー サービス ライブラリ

  • [アーティクル]

WIA ドライバー サービス ライブラリには、WIA ミニドライバーが特定のタスクの実行を支援するために呼び出すことができる関数が格納されています。

WIA ミニドライバーは、必要に応じて IWiaDrvItem Interface メソッドからこれらの関数のほとんどを呼び出します。 ただし、各 WIA ミニドライバーは、ドライバー項目を作成するために IWiaMiniDrv::drvInitializeWia メソッドの wiasCreateDrvItem 関数を呼び出す必要があります。 wiasCreateDrvItem 関数が正常に呼び出されるたびに、IWiaDrvItem 項目オブジェクトが作成されます。これはミニドライバーの項目ツリーで使用されます。 IWiaDrvItem インターフェイスのメソッドには、IWiaDrvItem::AddItemToFolder、IWiaDrvItem::GetFirstChildItem、IWiaDrvItem::GetNextSiblingItem、IWiaDrvItem::GetParentItem など、IWiaDrvItem 型のパラメーターがあります。 また、 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 項目から 1 つのバイナリ プロパティを読み取ります。
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 項目に 1 つのバイナリ プロパティ値を書き込みます。
wiasWritePropFloat WIA 項目に浮動小数点プロパティ値を書き込みます。
wiasWritePropGuid WIA 項目に GUID プロパティ値を書き込みます。
wiasWritePropLong WIA 項目に長整数プロパティ値を書き込みます。
wiasWritePropStr WIA 項目に文字列プロパティ値を書き込みます。

データの更新と転送

関数 説明
wiasDownSampleBuffer ピクセル データのバッファーを取り込み、指定したサイズにダウンサンプリングします。
wiasGetImageInformation 項目から転送コンテキスト情報を取得します。
wiasParseEndorserString 文字列の WIA サービス定義トークンとベンダー定義トークンをトークンに関連付けられた値に置き換えて、エンドーサ―の文字列を解析します。
wiasSendEndOfPage データ転送中にクライアント コールバック ルーチンを呼び出し、現在の合計ページ数を送信します。
wiasUpdateScanRect スキャン デバイスのスキャン領域のサイズを更新します。
wiasWriteBufToFile 一時ページ バッファーの内容をイメージ ファイルに書き込みます。
wiasWritePageBufToFile 一時ページ バッファーの内容をイメージ ファイルに書き込みます。 この関数を使用して、ページを複数ページからなる TIFF ファイルに書き込みます。