デバイス情報プロパティ定数

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

デバイス情報プロパティは、デバイスのセットアップとインストールを記述するプロパティです。これらのプロパティは、 IWiaDevMgr または IWiaDevMgr2 インターフェイスを介して、またルート項目を介して使用できます。デバイス情報プロパティの先頭には "WIA_DIP_" (デバイス情報プロパティ) が付き、Windows イメージ取得 (WIA) によって提供されます。スクリプトの目的で、これらの定数はプレフィックス "DeviceInfo" を使用し、 WiaDeviceInfoPropertyId 列挙型の一部です。そのスクリプト列挙の対応するメンバー名は、次の一覧の C/C++ 定数名の横にかっこで囲まれて表示されます。

WIA_DIP_DEV_ID
DeviceInfoDevId

WIA ミニドライバーのデバイス ID 文字列。 WIA サービスは、このプロパティを作成および維持します。
種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_DIP_VEND_DESC
DeviceInfoVendDesc

WIA ミニドライバーのベンダーの説明文字列。ベンダーの説明は、INF ファイルから取得されます。アプリケーションはこのプロパティを読み取り、デバイスベンダーの説明を取得します。 WIA サービスは、このプロパティを作成および維持します。
種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_DIP_DEV_DESC
DeviceInfoDevDesc

WIA ミニドライバーのデバイスの説明文字列。 WIA サービスは、このプロパティを作成および維持します。このプロパティに含まれるデバイス記述文字列は、INF ファイルから取得されます。アプリケーションはこのプロパティを読み取って、デバイスの説明を取得します。
種類: VT_BSTR、Access: 読み取り専用、有効な値: WIA_PROP_NONE

WIA_DIP_DEV_TYPE
DeviceInfoDevType

デバイスの種類とデバイスのサブタイプ。 WIA サービスは、このプロパティを作成および維持します。 GET_STIDEVICE_TYPE マクロを使用して、デバイスの種類を取得します。デバイスの種類とサブタイプは、INF ファイルから取得されます。アプリケーションはこのプロパティを読み取り、スキャナー、カメラ、またはビデオデバイスのどちらを使用しているかを判断します。
種類: VT_I4、Access: 読み取り専用、有効な値: WIA_PROP_NONE
現在、デバイスの種類は次のように定義されています。アスタリスク * は、デバイスの種類が Windows Vista 以降でサポートされていないことを示します。二重アスタリスク ** は、デバイスの種類が Windows Server 2003、Windows Vista 以降でサポートされていないことを示します。

Type	値	定義
StiDeviceTypeDefault	0x0000	既定のデバイス
StiDeviceTypeScanner	0x0001	スキャナーデバイス (スキャナーがフラットベッドかシートフィードかを判断するには、 WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES を参照してください)。
StiDeviceTypeDigitalCamera*	0x0002	カメラデバイス
StiDeviceTypeStreamingVideo**	0x0003	ビデオデバイス

WIA_DIP_PORT_NAME
DeviceInfoPortName

インストールされているデバイスのポート名。デバイスを操作するカーネルモードドライバーによって割り当てられます。 WIA サービスは、このプロパティを作成および維持します。アプリケーションは、このプロパティを読み取ってポート名を決定します。

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

WIA_DIP_DEV_NAME
DeviceInfoDevName

デバイスの名前。 WIA サービスは、このプロパティを作成および維持します。このプロパティに含まれるデバイス名は、INF ファイルから取得されます。アプリケーションはこのプロパティを読み取って、デバイスの名前を取得します。

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

WIA_DIP_SERVER_NAME
DeviceInfoServerName

WIA ミニドライバーが実行されているサーバーの名前。このプロパティは、Windows XP 以降では省略可能です。

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

WIA_DIP_REMOTE_DEV_ID
DeviceInfoRemoteDevId

リモートコンピューターにインストールされている WIA デバイスのデバイス ID。 WIA サービスは、このプロパティを作成および維持します。 WIA サービスによって内部でのみ使用されます。

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

WIA_DIP_UI_CLSID
DeviceInfoUIClsid

WIA ミニドライバーと共にインストールされている UI 拡張機能 COM オブジェクトのベンダー提供の CLSID。 WIA サービスは、このプロパティを作成および維持します。このプロパティに含まれる UI CLSID 値は、INF ファイルから取得されます。 UI CLSID が指定されていない場合、WIA サービスは既定値を提供します。このプロパティは、UI が表示されている場合にのみ WIA サービスによって内部的に使用されます。

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

WIA_DIP_HW_CONFIG
DeviceInfoHwConfig

デバイスが使用している接続の種類。 WIA サービスはこのプロパティを作成および維持し、WIA サービスのみが変更できます。

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

プロパティには、次の値を指定できます。

値	定義
1	汎用 WDM デバイス
2	SCSI デバイス
4	USB デバイス
8	シリアルデバイス
16	並列デバイス

WIA_DIP_BAUDRATE
DeviceInfoBaudRate

デバイスの現在のボーレート設定。 WIA サービスは、このプロパティを作成して維持します。デバイスがシリアルケーブルで接続されていない場合は、値は "空" にする必要があります。