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 ファイルに書き込みます。 |