一般的な WIA 項目プロパティ定数

次のデバイス プロパティ定数は、説明に特に記載がない限り、すべての IWiaItemIWiaItem2および IWiaDrvItem インターフェイス インターフェイス でサポートされている必要があります。

プレフィックス "WIA_IPA_" は、すべてのデバイスの項目プロパティを示し、C/C++ で使用される名前付け規則です。 スクリプトの目的で、これらの定数はプレフィックス "Picture" を使用し、 WiaItemPropertyId 列挙型の一部です。 そのスクリプト列挙体の対応するメンバー名は、次の一覧の C/C++ 定数名の横にあるかっこで囲んで表示されます。

定数/値 Description
WIA_IPA_ACCESS_RIGHTS
PictureAccessRights
このフラグは、アイテムへのアクセスと、アイテムが削除されるかどうかを制御します。
すべての WIA 2.0 アイテムに必要です。
型: VT_I4;アイテムのアクセス権を変更する機能に応じて、読み取り/書き込みまたは読み取り専用。有効な値: WIA_PROP_FLAG
次の表に、このプロパティで有効な 5 つのフラグを示します。
アクセス権 説明
WIA_ITEM_READ アイテムには読み取り専用アクセス権があります。
WIA_ITEM_WRITE アイテムには書き込み専用アクセス権があります。
WIA_ITEM_CAN_BE_DELETED アイテムには削除専用アクセス権があります。
WIA_ITEM_RD WIA_ITEM_READ |WIA_ITEM_CAN_BE_DELETED
WIA_ITEM_RWD WIA_ITEM_READ |WIA_ITEM_WRITE |WIA_ITEM_CAN_BE_DELETED

 

WIA_IPA_APP_COLOR_MAPPING
PictureAppColorMapping

このプロパティは将来使用するために によって予約されており、現時点では実装されていません。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_BITS_PER_CHANNEL
PictureBitsPerChannel

イメージのチャネルあたりのビット数を格納します。 ミニドライバーは、このプロパティを作成して維持します。

すべての WIA 2.0 取得が有効または保存されているイメージ項目に必要です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_BUFFER_SIZE
PictureBufferSize

データ転送中に使用されるバッファーのサイズをバイト単位で格納します。 ミニドライバーは、このプロパティを作成して維持します。

アプリケーションは、このプロパティを読み取って、データ転送のドライバー指定のバッファー サイズを決定できます。 WIA サービスは、データ転送中にミニドライバーのメモリを割り当てるためにもこのプロパティを読み取ります

すべての転送が有効な WIA 2.0 アイテムの場合は省略可能です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

注:
WIA_IPA_BUFFER_SIZE プロパティに含まれるのは、アプリケーションが任意の時点で要求できるデータの最小量です。 バッファー サイズが大きいほど、デバイスへの要求は大きくなります。 これにより、デバイスが低速で応答していないように見え、システム全体のパフォーマンスが低下し、過剰なリソースが消費される可能性があります。 バッファー サイズが小さすぎると、多くの小さな要求が必要になり、データ転送のパフォーマンスが低下する可能性があります。 デバイスへのデータ要求の一般的なサイズを考慮し、要求の数とそれらの要求のサイズのバランスを取ることで、適切なバッファー サイズを選択します。

 
WIA_IPA_BYTES_PER_LINE
PictureBytesPerLine

イメージの 1 つのスキャン行のバイト数を格納します。 ミニドライバーは、このプロパティを作成して維持します。

すべての WIA 2.0 項目の場合は省略可能です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_CHANNELS_PER_PIXEL
PictureChannelsPerPixel

画像のピクセルあたりのチャネル数を格納します。 ミニドライバーは、このプロパティを作成して維持します。

すべての WIA 2.0 取得が有効または保存されているイメージ項目に必要です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_COLOR_PROFILE
PictureColorProfile

このプロパティは将来使用するために によって予約されており、現時点では実装されていません。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_COMPRESSION
PictureCompression

使用されている現在の圧縮の種類が含まれます。 ミニドライバーは、このプロパティを作成して維持します。

アプリケーションは、このプロパティを読み取ってイメージの圧縮の種類を決定するか、このプロパティを設定して圧縮設定を構成します。

型: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST

次の表に、このプロパティで有効な定数を示します。 V 記号は、定数が Windows Vista 以降でのみサポートされていることを示します。 ( IWiaItem2 インターフェイス経由でのみ使用できます)。

[圧縮の種類] 説明
WIA_COMPRESSION_NONE 圧縮なし。 詳細については、「 注」 を参照してください。
WIA_COMPRESSION_AUTO 自動圧縮モード。 詳細については、「 注」 を参照してください。
WIA_COMPRESSION_BI_RLE4 RLE4 圧縮
WIA_COMPRESSION_BI_RLE8 RLE8 圧縮
WIA_COMPRESSION_G3 グループ 3 の圧縮
WIA_COMPRESSION_G4 グループ 4 の圧縮
WIA_COMPRESSION_JPEG JPEG 圧縮。
WIA_COMPRESSION_JBIGV JBIG 圧縮。
WIA_COMPRESSION_JPEG2KV JPEG 2000 圧縮。
WIA_COMPRESSION_PNGV PNG 圧縮。

 

[!注意]

このプロパティが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_IPA_DATATYPE
PictureDatatype

デバイスの現在のデータ型設定が含まれます。 ミニドライバーは、このプロパティを作成して維持します。

アプリケーションはこのプロパティを読み取って、イメージのデータ型を決定します。 アプリケーションはこのプロパティを書き込み、転送されるイメージの現在のデータ型を設定します。

このプロパティは、すべての 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_DATA_AUTO フラットベッドとフィーダーを含むすべてのプログラム可能な画像データ ソース項目に対して有効です。 WIA ミニ ドライバーでこの値がサポートされている場合、WIA アプリケーション クライアントは、デバイスで色の自動検出を有効にするためにWIA_IPA_DATATYPEを設定できます。 WIA_DATA_AUTOが設定されている場合、WIA ミニ ドライバーは、同じ項目のWIA_IPA_DEPTHをWIA_DEPTH_AUTOに更新する必要があります (デバイスが自動色をサポートしている場合は、サポートされる値である必要があります)。
これは省略可能な値ですが、WIA_IPA_DEPTHでWIA_DEPTH_AUTOがサポートされている場合は必須です。
WIA_DATA_COLOR スキャン データは赤、緑、青 (RGB) の色です。 フル カラー形式については、次の WIA プロパティを使用して説明 します:WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PLANAR
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_DATA_COLOR_DITHER WIA_DATA_COLORと同じですが、データは現在選択されているディザ パターンを使用してディザリングされます。
WIA_DATA_COLOR_THRESHOLD データのスキャン時にしきい値が使用される点を除き、WIA_DATA_COLORと同じです。 WIA_IPS_THRESHOLD値の色の値は、完全な明るさに変換されます。この値の下の色は黒に変換されます。
WIA_DATA_DITHER スキャン データは、現在選択されているディザ パターンを使用してディザリングされます。
WIA_DATA_GRAYSCALE スキャン データは強度を表します。 パレットは、固定の等間隔のグレースケールで、 WIA_IPA_DEPTH プロパティで指定された奥行きを持ちます。
WIA_DATA_THRESHOLD しきい値は、白黒データの 1 ピクセルあたり 1 ビットです。 WIA_IPS_THRESHOLDの現在の値に対するデータは白に変換されます。この値の下のデータは黒に変換されます。

 

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_DATA_GRAYSCALE スキャン データは強度を表します。 パレットは、 WIA_IPA_DEPTH プロパティで指定された奥行きを持つ、等間隔の固定グレースケールです。 WIA_IPA_RAW_BITS_PER_CHANNEL は 1 に設定する必要があります。
WIA_DATA_RAW_BGR スキャン データは、BGR (青-緑-赤) の色空間にあります。 フル カラー形式については、次のWIA プロパティを使用して説明 します:WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_IPA_RAW_BITS_PER_CHANNEL は 3 に設定する必要があります。
WIA_DATA_RAW_CMY スキャン データは、シアン マゼンタイエロー (CMY) カラースペースにあります。 フル カラー形式は、WIA_DATA_RAW_BGRと同じ WIA プロパティを使用して記述されます。 WIA_IPA_RAW_BITS_PER_CHANNEL は 3 に設定する必要があります。
WIA_DATA_RAW_CMYK スキャン データは、シアン マゼンタイエローブラック (CMYK) カラースペースにあります。 フル カラー形式は、WIA_DATA_RAW_BGRと同じ WIA プロパティを使用して記述されます。 WIA_IPA_RAW_BITS_PER_CHANNEL は 4 に設定する必要があります。
WIA_DATA_RAW_RGB スキャン データは、赤-緑-青 (RGB) の色空間にあります。 フル カラー形式は、WIA_DATA_RAW_BGRと同じ WIA プロパティを使用して記述されます。 WIA_IPA_RAW_BITS_PER_CHANNEL は 3 に設定する必要があります。
WIA_DATA_RAW_YUV スキャン データは、輝度-青差-赤差 (YUV) の色空間にあります。 フル カラー形式は、WIA_DATA_RAW_BGRと同じ WIA プロパティを使用して記述されます。 WIA_IPA_RAW_BITS_PER_CHANNEL は 3 に設定する必要があります。
WIA_DATA_RAW_YUVK スキャン データは、輝度-青差-赤差-黒 (YUVK) の色空間にあります。 フル カラー形式は、WIA_DATA_RAW_BGRと同じ WIA プロパティを使用して記述されます。 WIA_IPA_RAW_BITS_PER_CHANNEL は 4 に設定する必要があります。

 

WIA_IPA_DEPTH
PictureDepth

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_IPA_FILENAME_EXTENSION
PictureFilenameExtension

特定のファイル形式のファイル名拡張子を含みます。 ミニドライバーは、このプロパティを作成して維持します。

すべての転送が有効な WIA 2.0 項目の場合は省略可能です。

種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

ドライバーは、 WIA_IPA_FORMAT プロパティの現在の値を反映するように、このプロパティを更新します。

たとえば、 WIA_IPA_FORMAT がWiaImgFmt_JPEGの場合、 WIA_IPA_FILENAME_EXTENSIONjpg にする必要があります。 WIA_IPA_FORMATがWiaImgFmt_BMPの場合、WIA_IPA_FILENAME_EXTENSIONは BMP である必要があります。

注:
ファイル名拡張子にドットは含まれません。

 

このプロパティは、標準形式をサポートし、カスタム定義形式を実装するドライバーに必要なドライバーに推奨されます。 これは、プライベートフォーマットされたファイルの転送中に使用する正しいファイル名拡張子をアプリケーションに通知します。 たとえば、A. Datum Corporation が、ファイルを新しい形式で転送する WIA ドライバーを作成した場合、"adc" の拡張子を指定できます。 これにより、アプリケーションはその形式のデータをファイルに転送し、 myfile.adc などのファイル名を作成できます。これは、新しい拡張子を理解している他のユーザーにとって役立ちます。

WIA_IPA_FORMAT
PictureFormat

転送されるイメージの現在の形式が含まれます。

アプリケーションはこのプロパティを読み取り、受信しようとしているイメージの形式を決定します。 アプリケーションはこのプロパティを書き込み、形式を設定します。 このプロパティは 、WIA_IPA_TYMED プロパティによって異なります。 ミニドライバーは、このプロパティを作成して維持します。

デバイスを 1 つの値のみに設定できる場合は、 WIA_PROP_LIST 型を作成し、有効な値をその中に配置します。

種類: CLSID、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST

次の表に、このプロパティで有効な定数を示します。 アスタリスク * は、定数が Windows Vista でサポートされていないことを示します。 ( IWiaItem インターフェイス経由でのみ使用できます)。二重アスタリスク ** は、定数が Windows Server 2003 または Windows Vista でサポートされていないことを示します。 V 記号は、定数が Windows Vista 以降でのみサポートされていることを示します。 ( IWiaItem2 インターフェイス経由でのみ使用できます)。

Format 説明
WiaAudFmt_AIFF AIFF オーディオ形式
WiaAudFmt_MP3 MP3 オーディオ形式
WiaAudFmt_WAV WAV オーディオ形式
WiaAudFmt_WMA WMA オーディオ形式
WiaImgFmt_ASF** ASF ビデオ形式
WiaImgFmt_AVI** AVI ビデオ形式
WiaImgFmt_BMP ヘッダー ファイルを含む Windows ビットマップ
WiaImgFmt_CIFF* カメラ イメージ ファイルの形式
WiaImgFmt_DPOF DPOF 印刷形式
WiaImgFmt_EMF 拡張 Windows メタファイル
WiaImgFmt_EXEC 実行可能ファイル
WiaImgFmt_EXIF 交換可能なファイル形式
WiaImgFmt_FLASHPIX FlashPix 形式
WiaImgFmt_GIF GIF イメージの形式
WiaImgFmt_HTML HTML 形式
WiaImgFmt_ICO Windows アイコン ファイルの形式
WiaImgFmt_JBIGV Joint Bi レベルの Image Experts Group (JBIG) 形式。
WiaImgFmt_JPEG JPEG 圧縮形式
WiaImgFmt_JPEG2K JPEG 2000 圧縮形式
WiaImgFmt_JPEG2KX JPEG 2000 圧縮形式
WiaImgFmt_MEMORYBMP ヘッダー ファイルのない Windows ビットマップ
WiaImgFmt_PDFAV PDF/A (ISO/CD 19005-1) 形式。
WiaImgFmt_MPG** MPEG ビデオ形式
WiaImgFmt_PHOTOCD Eastman Kodak ファイル形式
WiaImgFmt_PICT Apple ファイル形式
WiaImgFmt_PNG W3C PNG 形式
WiaImgFmt_RAW データ転送専用の生形式
WiaImgFmt_RAWRGB 未加工の RGB 形式
WiaImgFmt_RTF リッチ テキスト ファイルの形式
WiaImgFmt_SCRIPT スクリプト ファイル
WiaImgFmt_TIFF タグ イメージ (TIFF) 形式
WiaImgFmt_TXT テキスト ファイル
WiaImgFmt_UNICODE16 UNICODE 16 ビット エンコード
WiaImgFmt_WMF Windows メタファイル
WiaImgFmt_XML XML ファイル
WiaImgFmt_XPSV XPS パッケージ形式

 

注:
このプロパティがWiaImgFmt_PDFAまたはWiaImgFmt_XPSであり、WIA_IPA_COMPRESSIONがWIA_COMPRESSION_NONEされている場合。後者の値は、圧縮モードが未定義であり、スキャナーがモードを決定する必要があることを意味します。

 
WIA_IPA_FULL_ITEM_NAME
PictureFullItemName

完全なアイテム名 (パス情報と共にアイテム名) を格納します。 完全な項目名は、wiasCreateDrvItem サービス ユーティリティ関数の bstrFullItemName パラメーターと同じです。 アプリケーションは、このプロパティを読み取って、現在使用している項目と、その項目がアイテム ツリー内のどこにあるかを判断します。 各項目には一意の名前を付ける必要があります。 アプリケーションでは、通常、完全なアイテム名を使用してアイテム ツリー内のアイテムを検索します。 WIA サービスは、このプロパティを作成および維持します。

すべての WIA 2.0 アイテムに必要です。

種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_GAMMA_CURVES
PictureGammaCurves

このプロパティは今後使用するために予約されており、現時点では実装されていません。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_ICM_PROFILE_NAME
PictureIcmProfileName

イメージを適切にデコードするために必要な ICM プロファイル名が含まれています。 アプリケーションは、このプロパティを読み取って、イメージの処理中に使用する ICM プロファイルを決定します。 WIA サービスは、ドライバー インストール ファイルの ICMProfiles エントリに基づいて、このプロパティを作成および維持します。

種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_ITEM_CATEGORY
PictureItemCategory

Windows Vista 以降でのみサポートされます。

WIA 2.0 項目は、 IWiaItem2 の処理方法または使用方法を定義するカテゴリにグループ化されます。 たとえば、アイテムがフィーダーを表す場合、アプリケーションでは、必要なドキュメント フィーダープロパティが含まれていることを想定し、ドキュメント フィーダーのように動作する必要があります。 アイテムが完成したファイルを表す場合、WIA 2.0 アプリケーションは、データが静的であり、デバイス上にあると仮定して、そのように処理する必要があります。 (各項目のルールは、個々の仕様ドキュメントで定義されます)。

すべての WIA 2.0 アイテムに必要です。

種類: VT_CLSID、Access: 読み取り専用、有効な値: 項目カテゴリ GUID

WIA_IPA_ITEM_FLAGS
PictureItemFlags

WIA 項目の説明フラグを含みます。 項目フラグは、wiasCreateDrvItem サービス ユーティリティ関数の lObjectFlags パラメーターと同じです。 WIA サービスは、このプロパティを作成および維持します。

アプリケーションはこのプロパティを読み取って、項目の説明フラグ値を決定します。

種類: VT_I4 Access: 読み取り専用、有効な値: WIA_PROP_NONE

次の表に、このプロパティで有効なフラグを示します。 アスタリスク * は、フラグが Windows Vista 以降ではサポートされていないことを示します。 ( IWiaItem インターフェイス経由でのみ使用できます)。二重アスタリスク ** は、フラグが Windows Server 2003 以降でサポートされていないことを示します。 V 記号は、フラグが Windows Vista 以降でのみサポートされていることを示します。 ( IWiaItem2 インターフェイス経由でのみ使用できます)。

フラグ 定義
WiaItemTypeAnalyze* この項目では、 IWiaItem::AnalyzeItem メソッドがサポートされています (プラットフォーム SDK のドキュメントで説明されています)。 この項目では、子項目の自動生成もサポートされています。 この機能は、リージョンの検出またはページ分解に役立ちます。
WiaItemTypeAudio この項目はオーディオをサポートしています。 このフラグは、 WiaItemTypeFile フラグも設定されているアイテムに対してのみ有効です。
WiaItemTypeBurst* フォルダーの場合のみ。 このフラグは、このフォルダー内のイメージが連続した時間シーケンスで取得されたことを示します。
WiaItemTypeDeleted このアイテムは削除対象としてマークされているか、このアイテムが削除されたか、このアイテムが存在しないか、このアイテムの内容が無効です。
WiaItemTypeDocumentV このアイテムは、 WIA_IPA_FORMAT プロパティに含まれるいずれかのドキュメント形式のドキュメント ファイルです。 (これらの形式には、.txt、.htm、.doc ファイルなど、イメージ化されていないファイルの形式が含まれます)。
WiaItemTypeDevice この項目は、接続されているデバイスを表します。
WiaItemTypeDisconnected この項目は、切断されたデバイスを表します。
WiaItemTypeFile アイテムはファイル転送をサポートしています。
WiaItemTypeFolder アイテムはフォルダーです。
WiaItemTypeFree アイテムが初期化されていないか、削除されています。
WiaItemTypeGenerated この項目は、アプリケーションまたはドライバーによって生成されています。
WiaItemTypeHasAttachments* このアイテムは添付ファイルをサポートしており、現在添付ファイルが含まれています。
WiaItemTypeHPanorama* この項目は、水平パノラマ画像を表します。 このフラグは、 WiaItemTypeFolder フラグも設定されているアイテムに対してのみ有効です。
WiaItemTypeImage 項目はイメージ ファイルです。 このフラグは、 WiaItemTypeFile フラグも設定されているアイテムに対してのみ有効です。
WiaItemTypeProgrammableDataSourceV 項目はプログラム可能なデータ ソースであり、 WIA_IPA_ITEM_CATEGORYに基づく定義済みの構成規則のセットに従います。
WiaItemTypeRootV このアイテムはルート アイテムであり、デバイスがサポートするすべての機能アイテムの親です。
WiaItemTypeStorage このフラグは、フォルダーアイテムの追加ストレージを示します。 WIA ドライバーは、イメージとフォルダーの観点から項目を指定します。 記憶域項目の特性 (残りの記憶域スペース、書き込み速度、メディアの種類など) を記述する WIA プロパティは存在しません。 この情報を公開するベンダー固有のプロパティを追加できます。 これらのプロパティにアクセスできるのは、それらを認識するように書き込まれたアプリケーションまたは拡張機能のみです。
WiaItemTypeTransfer このアイテムは、データの転送に使用できます。
WiaItemTypeTwainCapabilityPassThrough この種類は、WIA デバイスが TWAIN 互換性レイヤーから TWAIN 機能データを受信できることを示します。 この種類が設定されている場合、TWAIN 互換性レイヤーで認識されない TWAIN 機能がWIA ドライバーに渡されます。 これはルート項目に対してのみ有効です。
WiaItemTypeVideo** この項目では、ストリーミング ビデオがサポートされています。
WiaItemTypeVPanorama* この項目は、垂直方向のパノラマ画像を表します。 このフラグは、 WiaItemTypeFolder フラグも設定されているアイテムに対してのみ有効です。

 

次の表に示すように、これらのフラグの一部は、WIA 2.0 項目の項目のカテゴリに従って必須または省略可能です。

アイテムのカテゴリ 必須 オプション
WIA_CATEGORY_ROOT WiaItemTypeRoot WiaItemTypeFolder WiaItemTypeDevice WiaItemTypeDisconnected
WIA_CATEGORY_FLATBED WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (複数のスキャン領域項目がサポートされている場合、このフラグはWIA_CATEGORY_FLATBEDルート項目に対してのみ省略可能です)。
WIA_CATEGORY_FEEDER WIA_CATEGORY_FEEDER_FRONT WIA_CATEGORY_FEEDER_BACK WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder (WIA_CATEGORY_FEEDER_FRONT項目とWIA_CATEGORY_FEEDER_BACK項目が存在する場合、このフラグはWIA_CATEGORY_FEEDERルート項目に対してのみ省略可能です)。
WIA_CATEGORY_FILM (ルート) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder なし
WIA_CATEGORY_FILM (子) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile なし
WIA_CATEGORY_FOLDER WiaItemTypeStorage WiaItemTypeFolder WiaItemTypeDeleted
WIA_CATEGORY_FINISHED_FILE WiaItemTypeFile WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeAudio WiaItemTypeDeleted

 

WIA_IPA_ITEM_NAME
PictureItemName

アイテム名を格納します。 アプリケーションは、このプロパティを読み取って、現在使用している項目を決定します。 各項目には一意の名前があります。 WIA サービスは、このプロパティを作成および維持します。

すべての WIA 2.0 アイテムに必要です。

種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_ITEM_SIZE
PictureItemSize

アイテムに関連付けられているデータの現在のサイズをバイト単位で格納します。 ミニドライバーは、このプロパティを作成して維持します。

Contains は、転送されるデータの合計サイズです。 この値が 0 の場合は、ミニドライバーにデータの正確なサイズに関する情報がないことを意味します。 (これは圧縮データに共通です)。アプリケーションはこの値を読み取り、取得のサイズを決定してから取得を行います。 WIA サービスは、データ転送にメモリを割り当てるのに役立つこのプロパティを読み取ります。 詳細については、「 WIA アプリケーションへのデータの転送 」を参照してください。プロパティが 0 に設定され、TYMED がファイル転送用に構成されている場合、WIA サービスは WIA ミニドライバーにメモリを割り当てません。

すべての転送が有効な WIA 2.0 項目に必要です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_ITEM_TIME
PictureItemTime

イメージが最初にキャプチャされた時刻が含まれます。 ミニドライバーは、このプロパティを作成して維持します。 このプロパティは、SYSTEMTIME 構造体の形式で 8 つの WORD 値のベクターとして報告する必要があります (プラットフォーム SDK のドキュメントで説明)。

すべての WIA 2.0 項目の場合は省略可能です。

種類: VT_UI2 | VT_VECTOR Access: 読み取り/書き込みまたは読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
PictureItemItemsStored

Windows Vista 以降でのみサポートされます。

WIA_CATEGORY_FOLDER項目に格納される項目の数を指定します。

種類: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_NONE

WIA_IPA_MIN_BUFFER_SIZE
PictureMinBufferSize

データ転送で使用される最小バッファー サイズを指定します。 データ転送がコールバック メカニズムを介して実行される場合、プロパティ値は 64 KB まで小さくできます。 ただし、転送が file の場合、プロパティ値は一度に 1 ページのデータを転送するために必要なバイト数です。 ミニドライバーは、この WIA プロパティを作成して維持します。

すべての転送が有効な WIA 2.0 項目の場合は省略可能です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_NUMBER_OF_LINES
PictureNumberOfLines

画像に含まれる線の数 (画像の垂直方向の高さ (ピクセル単位) を格納します。 ミニドライバーは、このプロパティを作成して維持します。

すべての WIA 2.0 項目の場合は省略可能です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_PIXELS_PER_LINE
PicturePixelsPerLine

画像の各行のピクセル数 (画像の幅 (ピクセル単位) を格納します。 ミニドライバーは、このプロパティを作成して維持します。

すべての WIA 2.0 項目の場合は省略可能です。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_PLANAR
PicturePlanar

このプロパティは、Windows Vista 以降ではサポートされていません。

画像データのパッキング オプションが含まれます。 ミニドライバーは、このプロパティを作成して維持します。

アプリケーションは、このプロパティを読み取ってイメージ パッキング オプションを決定するか、現在のイメージ パッキング オプションを設定します。

型: VT_I4;アクセス: 読み取り/書き込み。有効な値: WIA_PROP_LIST。 デバイスを 1 つの値のみに設定できる場合は、WIA_PROP_LIST型を作成し、その中に有効な値を配置します。

次の表に、このプロパティで有効な 2 つの定数を示します。

定義
WIA_PACKED_PIXEL 画像データはパックピクセル形式です。
WIA_PLANAR 画像データは平面形式です。

 

WIA_IPA_PREFERRED_FORMAT
PicturePreferredFormat

このミニドライバーが転送するイメージの優先形式が含まれています。 ミニドライバーは、このプロパティを作成して維持します。

すべての転送が有効な WIA 2.0 項目に必要です。

種類: CLSID、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_PROP_STREAM_COMPAT_ID
PicturePropStreamCompatId

デバイス プロパティ値のセットを表す CLSID を指定します。 デバイス ドライバーがこの機能を実装している場合、アプリケーションはこのプロパティを使用して、デバイスが一連の値をサポートしているかどうかを判断します。

種類: CLSID、Access: 読み取り専用、有効な値: WIA_PROP_LIST

次の表に、このプロパティで有効な 12 個の定数を示します。

定義
WiaImgFmt_BMP ヘッダー ファイルを含む MicrosoftWindows ビットマップ
WiaImgFmt_EMF 拡張 Windows メタファイル
WiaImgFmt_EXIF 交換可能なファイル形式
WiaImgFmt_FLASHPIX FlashPix 形式
WiaImgFmt_GIF GIF イメージの形式
WiaImgFmt_ICO Windows アイコン ファイルの形式
WiaImgFmt_JPEG JPEG 圧縮形式
WiaImgFmt_PHOTOCD Eastman Kodak ファイル形式
WiaImgFmt_PNG W3C PNG 形式
WiaImgFmt_MEMORYBMP ヘッダー ファイルのない Windows ビットマップ
WiaImgFmt_TIFF タグ イメージ (TIFF) 形式
WiaImgFmt_WMF Windows メタファイル

 

WIA_IPA_RAW_BITS_PER_CHANNEL
PictureRawBitsPerChannel

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

WIA_IPA_REGION_TYPE
PictureRegionType

このプロパティは、今後使用するために によって予約されており、現時点では実装されていません。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_IPA_SUPPRESS_PROPERTY_PAGE
PictureSuppressPropertyPage

デバイス上のアイテムの一般的なプロパティ ページを非表示にするかどうかを指定します。

このプロパティは、Windows XP 以降で使用できます。

種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

次の表に、このプロパティで有効な定数を示します。 アスタリスク * は、定数が Windows Vista 以降では無効であることを示します。 ( IWiaItem インターフェイス経由でのみ使用できます)。

常時 説明
WIA_PROPPAGE_CAMERA_ITEM_GENERAL* カメラの一般的なアイテム プロパティ ページを非表示にします。
WIA_PROPPAGE_SCANNER_ITEM_GENERAL スキャナーの一般的な項目プロパティ ページを非表示にします。

 

WIA_IPA_TYMED
PictureTymed

このプロパティには、転送方法の設定が含まれています。 ミニドライバーは、このプロパティを作成して維持します。

アプリケーションは、このプロパティを読み取って、ミニドライバーのデータ転送方法を決定します。

すべての転送が有効な WIA 2.0 項目に必要です。

種類: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_LIST

次の表に、このプロパティで有効な定数を示します。 アスタリスク * は、Windows Vista 以降では無効な定数を示します。 ( IWiaItem インターフェイス経由でのみ使用できます)。

転送の種類 説明
TYMED_CALLBACK* イメージをメモリにバンド単位で転送します。
TYMED_MULTIPAGE_CALLBACK* 複数の画像をバンド単位でメモリに転送します。
TYMED_FILE イメージをファイルに転送します。
TYMED_MULTIPAGE_FILE イメージをファイルに転送します。

 

WIA_IPA_UPLOAD_ITEM_SIZE
PictureItemUploadItemSize

Windows Vista 以降でのみサポートされます。

アイテムにアップロードするバイト数を指定します。

種類: VT_I4、Access: 読み取り/書き込み、有効な値: WIA_PROP_NONE

必要条件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー
Wiadef.h