スキャナーデバイスプロパティ定数

[アーティクル]
06/13/2023

Windows イメージ取得 (WIA) ハードウェアデバイスには、Windows レジストリに格納されているプロパティ値があります。詳細については、「 Common Device Property Constants」を参照してください。関連付けられた文字列を含む次のデバイスプロパティ定数は、デジタルイメージスキャナーに固有です。

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

定数/値 Description

WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId

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

Web サービススキャナーデバイスの一意の関数インスタンス識別子が含まれます。この識別子は、WIA ミニドライバーが通信しているスキャナーデバイス上の Web サービスを表します。この識別子の形式に関する仮定は行うべきではありません。 WIA ミニドライバーは、このプロパティを作成し、維持します。
WIA アプリケーションでは、WIA_DPS_DEVICE_IDの値を使用して、Function Discovery API を使用して、現在の WIA 2.0 セッションで使用されている Web サービススキャナーデバイスを表す関数インスタンスオブジェクトを検索できます。
型: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_DPS_DITHER_PATTERN_DATA

予約済み。使用しないでください。
型: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_DPS_DITHER_SELECT

予約済み。使用しないでください。
型: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities

スキャナーの機能が含まれています。ミニドライバーは、このプロパティを作成して維持します。
アプリケーションは、このプロパティを読み取って、スキャナーにフラットベッド、ドキュメントフィーダー、またはデュプレクサがインストールされているかどうかを判断します。このプロパティは、インストールされている機能をさらに定義するためにも使用されます。
型: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE
次の表では、Windows 7 でのみ有効な定数について説明します。

Flags	説明
AUTO_SOURCE	スキャナーには、自動ドキュメントハンドラーがインストールされています。

次の表では、Windows 7 および Windows Vista でのみ有効な定数について説明します。

Flags	説明
ADVANCED_DUP	デバイスは、高度な双方向スキャン構成をサポートしています。基本的な双方向構成と高度な双方向構成の使用を切り替えるには、WIA_IPS_DUPLEX_SETTINGSを使用します。
DETECT_FILM_TPA	スキャナーは、透過性/フィルムアダプターをスキャンする準備ができたときに検出できます。
DETECT_STOR	スキャナーは、内部ストレージにドキュメントがある場合に検出できます。
FILM_TPA	スキャナーには透明/フィルムスキャンアダプターが装備されています。
STOR	スキャナーには内部イメージストレージデバイスが装備されています。

次の表では、Windows XP 以降で有効な定数について説明します。

Flags	説明
DETECT_FEED	スキャナーは、フィーダ内のドキュメントを検出できます。
DETECT_FLAT	スキャナーは、フラットベッドプラテン上のドキュメントを検出できます。
DETECT_SCAN	スキャナーは、スキャンによってのみ、フィーダ内のドキュメントを検出できます。
Dup	スキャナーにはデュプレクサがあります。
フィード	スキャナーには、自動ドキュメントハンドラーがインストールされています。
フラット	スキャナーにはフラットベッドプラテンがあります。

次の表では、Windows XP でのみ有効な定数について説明します。これらの値は、Windows 7 および Windows Vista では非推奨になっており、使用しないでください。

Flags	説明
DETECT_DUP	スキャナーは、ユーザーからの双方向スキャン要求を検出できます。
DETECT_DUP_AVAIL	スキャナーは、デュプレクサがいつインストールされているかを知ることができます。
DETECT_FEED_AVAIL	スキャナーは、自動ドキュメントフィーダがいつインストールされているかを確認できます。

WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_DOCUMENT_HANDLING_SELECTを使用 します。

現在のスキャナーの取得ソースとモードが含まれています。ミニドライバーは、このプロパティを作成して維持します。

アプリケーションは、このプロパティを読み取ってスキャナーの現在の取得ソースを決定するか、スキャナーのソースとモードを設定するためにこのプロパティを書き込みます。さらに、アプリケーションでは、このプロパティを使用して、デュプレクサー機能を有効または無効にします。

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

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

Flags	説明
フィーダー	ドキュメントフィーダを使用してスキャンします。
フラットベッド	フラットベッドを使用してスキャンします。
二重	デュプレクサ操作を使用してスキャンします。
AUTO_ADVANCE	スキャン後の次のドキュメントの自動フィードを有効にします。
FRONT_FIRST	最初にドキュメントの先頭をスキャンします。この値は、DUPLEX が設定されている場合に有効です。
BACK_FIRST	最初にドキュメントの背面をスキャンします。この値は、DUPLEX が設定されている場合に有効です。
FRONT_ONLY	フロントのみをスキャンします。この値は、DUPLEX が設定されている場合に有効です。
BACK_ONLY	背面のみをスキャンします。この値は、DUPLEX が設定されている場合に有効です。
NEXT_PAGE	ドキュメントの次のページをスキャンします。
PREFEED	事前フィードモードを有効にします。スキャン中に次のドキュメントを事前に配置します。

WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

スキャナーにインストールされているフラットベッド、ドキュメントフィーダー、またはデュプレクサの現在の状態が含まれます。ミニドライバーは、このプロパティを作成して維持します。

アプリケーションはこのプロパティを読み取り、スキャナーデバイスを使用する準備ができているかどうかを判断します。これは、画像を取得する前に紙が送り装置内にあるかどうかをチェックするのに理想的な方法です。

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

次の表に、このプロパティで有効な定数を示します。アスタリスク * は、フラグが Windows Vista 以降ではサポートされていないことを示します。 V 記号は、フラグが Windows Vista 以降でのみサポートされていることを示します。

Flags	説明
FEED_READY	フラットベッドは使用できる状態です。
FLAT_READY	スキャナーには、フラットベッドプラテンにドキュメントがあります。
DUP_READY	デュプレクサが有効になり、使用できる状態になります。
FLAT_COVER_UP	フラットベッドカバーが上にあります。
PATH_COVER_UP	用紙のパスが覆われ、適切な動作が妨げられます。
PAPER_JAM	ドキュメントがドキュメントフィーダに詰まっている。
FILM_TPA_READYV	透過性アダプターがインストールされ、使用できる状態になります。
STORAGE_READYV	内部ストレージデバイスの準備ができました。
STORAGE_FULLV	ストレージがいっぱいで、アップロード操作は不可能です。
MULTIPLE_FEEDV	複数のフィード条件が発生しました (通常はPAPER_JAM)。
DEVICE_ATTENTIONV	デバイスに対するユーザーの介入が必要なエラーがあります。
LAMP_ERRV	ランプの問題が原因でスキャナーの準備ができていない。

WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

アプリケーションが有効な保証文字列を作成するために使用できるすべての有効な文字が含まれます。保証者は、スキャンされたすべてのページにテキストメッセージをインプリントするスキャナーにインストールされたプリンターです。ミニドライバーは、このプロパティの有効な文字セットに対して 、WIA_DPS_ENDORSER_STRING プロパティの設定を検証する必要があります。ミニドライバーは、このプロパティを作成して維持します。

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

WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

ミニドライバーがスキャンする各ページで保証される (つまり、印刷される) 文字列が含まれます。アプリケーションは、 WIA_DPS_ENDORSER_CHARACTERS プロパティで報告される有効な文字セットを使用して、このプロパティを設定します。ミニドライバーは、このプロパティに文字列が設定されている場合にのみ、ドキュメントを保証する必要があります。空の文字列は、保証機能が無効になっていることを意味します。

保証文字列を解釈するのはドライバーの責任であるため、ドライバーは WIA_DPS_ENDORSER_STRINGで特殊文字を使用できます。ただし、アプリケーションだけがこれらの文字を理解します。

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

WIA_DPS_ENDORSER_STRING プロパティをサポートするドライバーは、次のトークンの一覧をサポートする必要があります。

トークン	説明
$DATE$	YYYY/MM/DD 形式の日付。
$DAY$	DD 形式の日。
$MONTH$	MM 形式の年の月。
$PAGE_COUNT$	転送されたページ数。
$TIME$	HH:MM:SS という形式の時刻。
$YEAR$	YYYY 形式の年。

WIA_DPS_FILTER_SELECT

予約済み、使用しないでください。

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

WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

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

Web サービススキャナーデバイスの SOAP アドレスを格納します。 WIA 2.0 ミニドライバーは、このプロパティを作成し、維持します。

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

WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

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

フラットベッドに配置されたドキュメントの登録 (水平配置) を格納します。ミニドライバーは、このプロパティを作成して維持します。

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

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

常時	説明
LEFT_JUSTIFIED	紙は両端揃えのままです。
中心	用紙は中央揃えです。
RIGHT_JUSTIFIED	紙は正しく正当化されます。

参照

WIA_DPS_VERTICAL_BED_REGISTRATION

WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_MAX_HORIZONTAL_SIZEを使用 します。

現在の解像度でフラットベッドスキャナーのプラテンから水平 (X) 軸でスキャンされる最大幅を 1 インチの 1000 分の 1 単位で指定します。このプロパティは、スキャン用のフラットベッドスキャナーのプラテンにシートを移動する自動ドキュメントフィーダーにも適用されます。このプロパティは、プラテンを持つスキャナーに必須です。他のスキャナーの種類では、 代わりに WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE プロパティが実装されます。

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

WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_MAX_HORIZONTAL_SIZEを使用 します。

現在の解像度でハンドヘルドまたはシートフィードスキャナーから水平 (X) 軸でスキャンされる最大幅を 1 インチの 1000 分の 1 単位で指定します。このプロパティは、フラットベッドスキャナーのプラテンにシートを移動せずにスキャンする自動ドキュメントフィーダーにも適用されます。このプロパティは、シートフィード、スクロールフィード、および手持ちスキャナーに必須です。

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

WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

現在のプロパティ設定を使用して 1 つのページをスキャンする最大時間 (ミリ秒単位) が含まれます。アプリケーションはこのプロパティを読み取り、ページのスキャンにかかる時間を見積もります。これは、応答を停止したデバイスの条件を判断するときに役立ちます。ミニドライバーは、このプロパティを作成して維持します。このプロパティは、すべてのスキャナーに必要です。

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

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_MIN_HORIZONTAL_SIZEを使用 します。

スキャナーのドキュメントフィーダがスキャンできる最小ページの物理的な水平寸法を 1000 分の 1 インチ単位で格納します。ミニドライバーは、このプロパティを作成して維持します。

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

参照

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_MIN_VERTICAL_SIZEを使用 します。

スキャナーのドキュメントフィーダがスキャンできる最小ページの物理的な垂直寸法を 1000 分の 1 インチ単位で格納します。ミニドライバーは、このプロパティを作成して維持します。

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

参照

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE

WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_OPTICAL_XRESを使用 します。

水平方向の光学解像度。 DPI でサポートされる最高の水平光学解像度。このプロパティは 1 つの値です。これは、デバイスによって生成できるすべての解像度の一覧ではありません。むしろ、これはデバイスの光学の解像度です。ミニドライバーは、このプロパティを作成して維持します。このプロパティは、すべてのスキャナーに必要です。

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

WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_OPTICAL_YRESを使用 します。

垂直光学解像度。 DPI でサポートされる最高の垂直光学解像度。このプロパティは 1 つの値です。これは、デバイスによって生成されるすべての解像度の一覧ではありません。むしろ、これはデバイスの光学の解像度です。ミニドライバーは、このプロパティを作成して維持します。このプロパティは、すべてのスキャナーに必要です。

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

WIA_DPS_ORIENTATION
ScannerDeviceOrientation

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

取得するページまたはイメージの元の向きを定義するために、アプリケーションによって WIA_DPS_ORIENTATION プロパティが設定されます。 WIA_DPS_ORIENTATIONの使用方法については、「WIA_DPS_PAGE_SIZE

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

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

値	定義
LANDSCAPE	縦向きに対する 90 度の反時計回りの回転。
肖像画	0 度。
ROT180	縦向きに対する 180 度の反時計回りの回転。
ROT270	縦向きに対する 270 度の反時計回りの回転。

参照

WIA_IPS_ROTATION

WIA_DPS_PAD_COLOR
ScannerDevicePadColor

要求されたバッファーを埋めるのに十分なイメージデータがない場合に埋め込むための色。このプロパティは、バッファーを埋め込むスキャナーに実装されます。このプロパティは、すべてのスキャナーで省略可能です。ミニドライバーは、このプロパティを作成して維持します。

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

色情報の形式は RGBQUAD です。

WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_PAGE_HEIGHTを使用 します。

現在選択されているページの高さを 1 インチの 1000 分の 1 インチ単位で格納します。ミニドライバーは、 WIA_DPS_PAGE_HEIGHT プロパティを作成して維持します。アプリケーションはこのプロパティを読み取って、スキャンされるページの物理的なサイズを決定します。エクステントの設定が既知のページサイズと異なる場合、このプロパティは 、WIA_DPS_PAGE_SIZE プロパティが WIA_PAGE_CUSTOM に設定されているページの高さ ( WIA_DPS_PAGE_SIZE プロパティの値) を報告します。 WIA_DPS_PAGE_HEIGHT は、スキャンするページの高さをピクセル単位で報告する WIA_IPS_XEXTENTと同期している必要があります。

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

WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_PAGE_SIZEを使用 します。

スキャン対象として現在選択されているページのサイズを格納します。スキャンするページのサイズを選択するには、アプリケーションによってこのプロパティが設定されます。ミニドライバーは、このプロパティを作成して維持します。

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

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

値	定義
WIA_PAGE_A4	8267 X 11692 (縦向き)
WIA_PAGE_CUSTOM	WIA_DPS_PAGE_HEIGHTプロパティとWIA_DPS_PAGE_WIDTHプロパティの値によって定義されます
WIA_PAGE_LETTER	8500 X 11000 (縦向き)

WIA_IPS_ORIENTATION プロパティの値によって、現在選択されているページの向きが決まります。 WIA_DPS_PAGE_WIDTHプロパティとWIA_DPS_PAGE_HEIGHT プロパティは、ページのサイズを 1000 分の 1 インチ単位で報告します。これらのプロパティは、ページのサイズをピクセル単位で含む WIA_IPS_XEXTENTおよびWIA_IPS_YEXTENTと一致している必要があることに注意してください。 WIA_PROP_LIST型の有効な値は、 WIA_IPS_ORIENTATION プロパティの有効な設定によって異なります。デバイスがWIA_PAGE_A4設定の横向きのドキュメントをスキャンできない場合、WIA_IPS_ORIENTATIONが LANSCAPE に設定されている場合、 WIA_DPS_PAGE_SIZE プロパティの有効な値の一覧 にWIA_PAGE_A4 は表示されません。

アプリケーション で WIA_DPS_PAGE_SIZE を WIA_PAGE_CUSTOM 以外の値に設定する場合、ミニドライバーは 、WIA_DPS_PAGE_WIDTH の値を調整し、ページのサイズを 1000 分の 1 インチ単位で WIA_DPS_PAGE_HEIGHT する必要があります。また、 WIA_IPS_XEXTENT の値を調整し、ページのサイズをピクセル単位で WIA_IPS_YEXTENT する必要があります。

エクステント設定 (WIA_IPS_XEXTENT または WIA_IPS_YEXTENT) が現在のページサイズ設定と一致しない値に変更された場合、ミニドライバーは WIA_DPS_PAGE_SIZE プロパティの値を WIA_PAGE_CUSTOM に変更する必要があります。ミニドライバーは、新しいエクステント設定に従って WIA_DPS_PAGE_WIDTHまたはWIA_DPS_PAGE_HEIGHT も変更する必要があります。

WIA_IPS_ORIENTATIONが LANSCAPE に設定されている場合、エクステント設定は "反転" されます。たとえば、アプリケーションで WIA_DPS_PAGE_SIZE を WIA_PAGE_A4 に設定する場合、ミニドライバーは WIA_DPS_PAGE_WIDTH を 11692 に、WIA_DPS_PAGE_HEIGHTを 8267 に設定する必要があります。 (ミニドライバーは、それに応じて WIA_IPS_XEXTENT と WIA_IPS_YEXTENT も設定する必要があります)。 WIA_DPS_PAGE_SIZE がWIA_PAGE_CUSTOMに設定されている場合、スキャンするページの範囲の寸法を決定するために向きの設定は使用されないことに注意してください。

ミニドライバーは、 WIA_IPS_ORIENTATION プロパティが現在の選択領域と一致していることを確認する責任があります。アプリケーションで WIA_IPS_ORIENTATION の値が現在選択されているページサイズに対して無効な値に変更された場合、ミニドライバーは WIA_DPS_PAGE_SIZE の値を、新しい向きの値でサポートされているページサイズに変更する必要があります。

アプリケーションで WIA_DPS_PAGE_SIZE プロパティを WIA_PAGE_CUSTOM に設定した場合、現在の選択領域は影響を受けません。 WIA ミニドライバーは、WIA_IPS_XPOSと WIA_IPS_YPOS プロパティの現在の設定から、現在のイメージレイアウトを取得する必要があります。ページサイズ設定の結果、スキャナーのベッドの外側にある選択領域が表示される場合、ミニドライバーは WIA_IPS_XPOSの値 を自動的に調整し、プロパティを有効な設定に WIA_IPS_YPOS する必要があります。 WIA_DPS_PAGE_SIZEプロパティとWIA_IPS_ORIENTATIONプロパティが同時に設定されていて、組み合わせて適用すると無効な場合、ミニドライバーは IWiaMiniDrv::d rvValidateItemProperties でエラーを返すことで、アプリケーションの設定を失敗させる必要があります。 .

次の 4 つの例は、さまざまな WIA_DPS_PAGE_SIZE シナリオを示しています。

ドライバーが設定を報告します。
アプリケーションは、 WIA_DPS_PAGE_SIZE プロパティを WIA_PAGE_LETTER に設定します。
アプリケーションは 、WIA_IPS_ORIENTATION プロパティを LANSCAPE に設定します。
アプリケーションは 、WIA_IPS_XEXTENT プロパティを小さい値に変更します。

例 1: ミニドライバーが設定を報告する

次の例では、アプリケーションが WIA プロパティを設定する前に、ミニドライバーによってカスタム選択領域が設定されます。この場合、選択領域はフラットベッド全体を表します。

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

例 2: アプリケーションでWIA_DPS_PAGE_SIZEプロパティを WIA_PAGE_LETTER に設定する

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

例 3: アプリケーションがWIA_IPS_ORIENTATIONプロパティを LANSCAPE に設定する

物理ベッドは、もともと横向きのページを取得できる必要があります。

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

例 4: アプリケーションがWIA_IPS_XEXTENTプロパティを小さい値に変更する

次の例では、アプリケーションによって WIA_IPS_XEXTENT プロパティが 1000 に変更されています。ミニドライバーは、 WIA_IPS_XEXTENT に含まれる新しい値が WIA_DPS_PAGE_SIZE プロパティに対して有効ではなくなったと想定し、 WIA_DPS_PAGE_SIZE を WIA_PAGE_CUSTOM に変更する必要があります。ミニドライバーは 、WIA_DPS_PAGE_WIDTHも調整する必要があります。

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_PAGE_WIDTHを使用 します。

選択されている現在のページの幅 (1000 分の 1 インチ単位) が含まれます。アプリケーションはこのプロパティを読み取って、スキャンされるページの物理的なサイズを決定します。エクステント設定が既知のページサイズと異なる場合、このプロパティは 、WIA_DPS_PAGE_SIZE プロパティが WIA_PAGE_CUSTOM に設定されているページの幅を報告します。 WIA_DPS_PAGE_WIDTH は、スキャンするページの幅をピクセル単位で報告する WIA_IPS_XEXTENTの値と同期している必要があります。ミニドライバーは、このプロパティを作成して維持します。

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

WIA_DPS_PAGES
ScannerDevicePages

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_PAGESを使用 します。

自動ドキュメントフィーダから取得する現在のページ数を格納します。ミニドライバーは、このプロパティを作成して維持します。

型: VT_I4;アクセス: 読み取り/書き込み。有効な値: WIA_PROP_RANGE (ドキュメントフィーダが保持できるページの最大数から 0)

アプリケーションはこのプロパティを読み取って、ドキュメントフィーダーのページ容量を決定します。また、このプロパティは、スキャンするページ数にも設定されます。

注:
二重モードが有効になっている場合 (WIA_DPS_DOCUMENT_HANDLING_SELECT が FEEDER に設定されている場合 |DUPLEX ) 、WIA_DPS_PAGES はスキャンするページの数と同じです。

両面印刷が有効になっている場合、ページの裏面が空白の場合でも、1 枚の用紙に 2 ページが自動的に含まれます。

WIA_DPS_PAGESを 1 に設定すると、スキャナーはページの両側の 1 つを処理します。双方向モードの間にスキャナーがページの片側のみをスキャンできない場合は、WIA_PROPERTY_INFO構造体の Inc メンバーの有効な値WIA_DPS_PAGESを 2 に変更することをお勧めします。この値は、2 つの倍数のページを要求する必要があることをアプリケーションに通知します。値が 0 の場合、ドキュメントフィーダに現在読み込まれている すべての ページがスキャンされます。

WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

スキャンするシートの背面にあるプラテンの色を指定します。このプロパティは、プラテンを持つスキャナーでは省略可能です。ミニドライバーは、このプロパティを作成して維持します。

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

色情報の形式は RGBQUAD です。

WIA_DPS_PREVIEW
ScannerDevicePreview

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_PREVIEWを使用 します。

デバイスのプレビューモードを示します。アプリケーションは、デバイスをプレビューモードにするようにこのプロパティを設定します。

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

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

値	定義
WIA_FINAL_SCAN	アプリケーションは最終スキャンを実行します。
WIA_PREVIEW_SCAN	アプリケーションはプレビュースキャンを実行します。

WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

スキャナーがページをアプリケーションに送信する前にスキャナーバッファーにキャッシュするかどうかを示す値を格納します。

値が 0 の場合、先行スキャンが無効になり、先にスキャンされるページはありません。バッファー内のスキャン先行項目で通常のデータ転送を実行すると、バッファー内のページが取得されます。スキャンアヘッド操作中に WIA プロパティを変更することはできません。このプロパティは省略可能です。

種類: VT_I4、Access: 読み取り/書き込み、有効な値: 0 からドキュメントフィーダーが保持できる最大ページ数までのWIA_PROP_RANGE。

WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

注:
このプロパティは、Windows 7 以降でのみサポートされています。

スキャン元の入力ソース (フラットベッド、自動ドキュメントフィーダー、または fil-scanning アダプター)、またはデータ転送元の格納場所を示します。

スキャンイベントは、ユーザーがスキャンを開始したことをアプリケーションに通知しますが、イベントは入力ソースを表す WIA 項目の名前を指定しません。アプリケーションのイベントハンドラーは、ルート項目の WIA_DPS_SCAN_AVAILABLE_ITEM プロパティに対してクエリを実行して、入力ソース項目の名前を取得できます。

種類: VT_I4、Access: 読み取り/書き込み、有効な値: 0 からドキュメントフィーダーが保持できる最大ページ数までのWIA_PROP_RANGE。

WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

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

Web サービススキャナーデバイスのサービス ID が含まれます。 WIA 2.0 ミニドライバーは、このプロパティを作成し、維持します。

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

WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_SHEET_FEEDER_REGISTRATIONを使用 します。

フラットベッドに配置されたドキュメントの登録 (配置とエッジの検出) が含まれます。ミニドライバーは、このプロパティを作成して維持します。このプロパティは、ハンドヘルドスキャナーまたはシートフィードスキャナーのスキャンヘッドにシートを水平方向に配置する方法を示します。プロパティは、スキャンヘッド全体でドキュメントが配置される場所を予測するために使用されます。

複数のスキャンヘッドをサポートするスキャナーの場合、このプロパティは最上位のスキャンヘッドに対して相対的です。このプロパティは、シートフィード、スクロールフィード、およびハンドヘルドスキャナーでは必須です。

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

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

常時	説明
LEFT_JUSTIFIED	シートはスキャンヘッドに対して左に配置されます。
中心	シートはスキャンヘッドの中央に配置されます。
RIGHT_JUSTIFIED	シートはスキャンヘッドに対して右側に配置されます。

WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

注:
このプロパティは、Windows Vista ではサポートされていません。 WIA_IPS_SHOW_PREVIEW_CONTROLを使用 します。

アイテムにプレビューコントロールをユーザーに表示する必要があるかどうかを示します。ミニドライバーは、このプロパティを作成して維持します。

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

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

常時	説明
WIA_SHOW_PREVIEW_CONTROL	このデバイスはプレビューを実行できるため、プレビューコントロールをユーザーに表示します。
WIA_DONT_SHOW_PREVIEW_CONTROL	このデバイスはプレビューを実行できないため、プレビューコントロールをユーザーに表示しないでください。

WIA_DPS_USER_NAME
ScannerDeviceUserName

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

現在の WIA アプリケーションが実行されているセッションのユーザーアカウント名 (該当する場合はネットワークドメイン名を含む) をミニドライバーに通知するために WIA サービスによって使用されます。

これは、WIA サービスによって管理されるルート項目プロパティです。

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

WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

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

フラットベッドに配置されたドキュメントの登録 (垂直配置とエッジ検出) が含まれます。ミニドライバーは、このプロパティを作成して維持します。

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

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

常時	説明
TOP_JUSTIFIED	紙は上揃えです。
中心	用紙は中央揃えです。
BOTTOM_JUSTIFIED	紙は底揃えです。

「」も参照してください。

WIA_DPS_HORIZONTAL_BED_REGISTRATION

WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_MAX_VERTICAL_SIZEを使用 します。

現在の解像度でフラットベッドスキャナーのプラテンから垂直 (Y) 軸でスキャンされる最大高さを 1 インチの 1000 分の 1 単位で指定します。このプロパティは、スキャン用のフラットベッドスキャナーのプラテンにシートを移動する自動ドキュメントフィーダにも適用されます。このプロパティは、プラテンを持つスキャナーに必須です。その他のスキャナーの種類では、 代わりに WIA_DPS_VERTICAL_SHEET_FEED_SIZE プロパティが実装されます。

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

WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

注:
このプロパティは、Windows Vista 以降ではサポートされていません。 WIA_IPS_MAX_VERTICAL_SIZEを使用 します。

現在の解像度でハンドヘルドまたはシートフィードスキャナーから垂直 (Y) 軸でスキャンされる最大高さを 1 インチの 1000 分の 1 単位で指定します。このプロパティは、フラットベッドスキャナーのプラテンにシートを移動せずにスキャンする自動ドキュメントフィーダーにも適用されます。このプロパティは、シートフィードスキャナーでは必須です。スクロールフィードスキャナーと手持ちスキャナーでは、このプロパティを実装しないでください。

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

必要条件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
ヘッダー	Wiadef.h

次の方法で共有

スキャナーデバイスプロパティ定数

必要条件

フィードバック

その他のリソース