一般的な WIA 項目プロパティ定数
次のデバイス プロパティ定数は、説明に特に記載がない限り、すべての IWiaItem、 IWiaItem2 、 および IWiaDrvItem インターフェイス インターフェイス でサポートされている必要があります。
プレフィックス "WIA_IPA_" は、すべてのデバイスの項目プロパティを示し、C/C++ で使用される名前付け規則です。 スクリプトの目的で、これらの定数はプレフィックス "Picture" を使用し、 WiaItemPropertyId 列挙型の一部です。 そのスクリプト列挙体の対応するメンバー名は、次の一覧の C/C++ 定数名の横にあるかっこで囲んで表示されます。
| 定数/値 | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
このフラグは、アイテムへのアクセスと、アイテムが削除されるかどうかを制御します。 すべての WIA 2.0 アイテムに必要です。 型: VT_I4;アイテムのアクセス権を変更する機能に応じて、読み取り/書き込みまたは読み取り専用。有効な値: WIA_PROP_FLAG 次の表に、このプロパティで有効な 5 つのフラグを示します。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
このプロパティは将来使用するために によって予約されており、現時点では実装されていません。 種類: 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
注: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
イメージの 1 つのスキャン行のバイト数を格納します。 ミニドライバーは、このプロパティを作成して維持します。 すべての 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 インターフェイス経由でのみ使用できます)。
[!注意] このプロパティが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 ミニ ドライバーは、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 に設定されていない場合に有効な 6 つの定数を示します。
WIA_IPA_DATATYPE プロパティは、アプリケーションがWiaImgFmt_RAWを設定するときに使用される RAW データ転送の種類を記述するためにも使用されます。 ドライバーは 、WIA_IPA_DATATYPE プロパティを、アプリケーションが選択できる許可される値の一覧に設定する必要があります。 デバイスを 1 つの値のみに設定できる場合は、 WIA_PROP_LIST 型を作成し、有効な値をその中に配置します。 WIA_IPA_DEPTH プロパティを調べて、ビット深度を確認します。 通常、このプロパティにはカメラの 1 つの値が含まれます。 次の表に、WIA_IPA_FORMATが WiaImgFmt_RAW に設定されている場合にWIA_IPA_DATATYPEで有効な定数を示します。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WIA_IPA_DEPTH イメージのビット深度設定が含まれます。 ミニドライバーは、このプロパティを作成して維持します。アプリケーションはこのプロパティを読み取って、イメージのビット深度設定を決定します。 アプリケーションでは、この値を目的のビット深度に設定することもできます。 デバイスを 1 つの値のみに設定できる場合は、 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がサポートされている場合は必須になります。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
特定のファイル形式のファイル名拡張子を含みます。 ミニドライバーは、このプロパティを作成して維持します。 すべての転送が有効な 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 プロパティによって異なります。 ミニドライバーは、このプロパティを作成して維持します。 デバイスを 1 つの値のみに設定できる場合は、 WIA_PROP_LIST 型を作成し、有効な値をその中に配置します。 種類: CLSID、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST 次の表に、このプロパティで有効な定数を示します。 アスタリスク * は、定数が Windows Vista でサポートされていないことを示します。 ( IWiaItem インターフェイス経由でのみ使用できます)。二重アスタリスク ** は、定数が Windows Server 2003 または Windows Vista でサポートされていないことを示します。 V 記号は、定数が Windows Vista 以降でのみサポートされていることを示します。 ( IWiaItem2 インターフェイス経由でのみ使用できます)。
注: |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
完全なアイテム名 (パス情報と共にアイテム名) を格納します。 完全な項目名は、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 以降でサポートされていないことを示します。 V 記号は、フラグが Windows Vista 以降でのみサポートされていることを示します。 ( IWiaItem2 インターフェイス経由でのみ使用できます)。
次の表に示すように、これらのフラグの一部は、WIA 2.0 項目の項目のカテゴリに従って必須または省略可能です。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
アイテム名を格納します。 アプリケーションは、このプロパティを読み取って、現在使用している項目を決定します。 各項目には一意の名前があります。 WIA サービスは、このプロパティを作成および維持します。 すべての WIA 2.0 アイテムに必要です。 種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
アイテムに関連付けられているデータの現在のサイズをバイト単位で格納します。 ミニドライバーは、このプロパティを作成して維持します。 Contains は、転送されるデータの合計サイズです。 この値が 0 の場合は、ミニドライバーにデータの正確なサイズに関する情報がないことを意味します。 (これは圧縮データに共通です)。アプリケーションはこの値を読み取り、取得のサイズを決定してから取得を行います。 WIA サービスは、データ転送にメモリを割り当てるのに役立つこのプロパティを読み取ります。 詳細については、「 WIA アプリケーションへのデータの転送 」を参照してください。プロパティが 0 に設定され、TYMED がファイル転送用に構成されている場合、WIA サービスは WIA ミニドライバーにメモリを割り当てません。 すべての転送が有効な WIA 2.0 項目に必要です。 種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
イメージが最初にキャプチャされた時刻が含まれます。 ミニドライバーは、このプロパティを作成して維持します。 このプロパティは、SYSTEMTIME 構造体の形式で 8 つの WORD 値のベクターとして報告する必要があります (プラットフォーム SDK のドキュメントで説明)。 すべての WIA 2.0 項目の場合は省略可能です。 種類: VT_UI2 | VT_VECTOR Access: 読み取り/書き込みまたは読み取り専用、有効な値: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Windows Vista 以降でのみサポートされます。 WIA_CATEGORY_FOLDER項目に格納される項目の数を指定します。 種類: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
データ転送で使用される最小バッファー サイズを指定します。 データ転送がコールバック メカニズムを介して実行される場合、プロパティ値は 64 KB まで小さくできます。 ただし、転送が file の場合、プロパティ値は一度に 1 ページのデータを転送するために必要なバイト数です。 ミニドライバーは、この 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 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
このプロパティは、Windows Vista 以降ではサポートされていません。 画像データのパッキング オプションが含まれます。 ミニドライバーは、このプロパティを作成して維持します。 アプリケーションは、このプロパティを読み取ってイメージ パッキング オプションを決定するか、現在のイメージ パッキング オプションを設定します。 型: VT_I4;アクセス: 読み取り/書き込み。有効な値: WIA_PROP_LIST。 デバイスを 1 つの値のみに設定できる場合は、WIA_PROP_LIST型を作成し、その中に有効な値を配置します。 次の表に、このプロパティで有効な 2 つの定数を示します。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
このミニドライバーが転送するイメージの優先形式が含まれています。 ミニドライバーは、このプロパティを作成して維持します。 すべての転送が有効な WIA 2.0 項目に必要です。 種類: CLSID、Access: 読み取り専用、有効な値: WIA_PROP_NONE |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
デバイス プロパティ値のセットを表す CLSID を指定します。 デバイス ドライバーがこの機能を実装している場合、アプリケーションはこのプロパティを使用して、デバイスが一連の値をサポートしているかどうかを判断します。 種類: CLSID、Access: 読み取り専用、有効な値: WIA_PROP_LIST 次の表に、このプロパティで有効な 12 個の定数を示します。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Windows Vista 以降でのみサポートされます。 各チャネルのビット数を格納します。 このプロパティは、チャネルと同じ数の BYTE 値のベクトルとして報告する必要があります。最初の BYTE は最初のチャネルのビット数、2 番目のバイトは 2 番目のチャネルのビット数などに対応します。 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 インターフェイス経由でのみ使用できます)。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
このプロパティには、転送方法の設定が含まれています。 ミニドライバーは、このプロパティを作成して維持します。 アプリケーションは、このプロパティを読み取って、ミニドライバーのデータ転送方法を決定します。 すべての転送が有効な 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 [デスクトップ アプリのみ] |
| ヘッダー |
|