デバイス インスタンスのプロパティへのアクセス (Windows Vista より前)

  • [アーティクル]

Windows Vista 以降のバージョンの Windows では、統合デバイス プロパティ モデルは、cfgmgr32.hで定義されているCM_DRP_Xxx識別子と Setupapi.hで定義されているSPDRP_Xxx識別子に対応するデバイス インスタンス プロパティをサポートしています。 これらのプロパティは、デバイス インスタンスの構成を特徴付けます。 統合デバイス プロパティ モデルでは、プロパティ キーを使用してこれらのプロパティを表します。 Windows Server 2003、Windows XP、および Windows 2000 では、これらのデバイス のプロパティもサポートされています。 ただし、これらの以前のバージョンの Windows では、統合デバイス プロパティ モデルのプロパティ キーはサポートされていません。 代わりに、これらの以前のバージョンの Windows では、CM_DRP_Xxx または SPDRP_Xxx 識別子を使用して、デバイス インスタンスのプロパティを表し、アクセスします。

これらの以前のバージョンの Windows との互換性メイン維持するために、Windows Vista 以降のバージョンでは、デバイス インスタンスのプロパティにアクセスするためのCM_DRP_XxxまたはSPDRP_Xxx識別子の使用もサポートされています。 ただし、Windows Vista 以降のバージョンでこれらのプロパティにアクセスするには、対応するプロパティ キーを使用する必要があります。

対応するCM_DRP_XxxまたはSPDRP_Xxx識別子を持つシステム定義デバイス インスタンス プロパティの一覧については、次の表を参照してください。

統合プロパティ モデル プロパティ CM_DRP_Xxx値 SPDRP_Xxx値
DEVPKEY_Device_DeviceDesc CM_DRP_DEVICEDESC SPDRP_DEVICEDESC
DEVPKEY_Device_HardwareIds CM_DRP_HARDWAREID SPDRP_HARDWAREID
DEVPKEY_Device_CompatibleIds CM_DRP_COMPATIBLEIDS SPDRP_COMPATIBLEIDS
DEVPKEY_Device_Service CM_DRP_SERVICE SPDRP_SERVICE
DEVPKEY_Device_Class CM_DRP_CLASS SPDRP_CLASS
DEVPKEY_Device_ClassGuid CM_DRP_CLASSGUID SPDRP_CLASSGUID
DEVPKEY_Device_ConfigFlags CM_DRP_CONFIGFLAGS SPDRP_CONFIGFLAGS
DEVPKEY_Device_Manufacturer CM_DRP_MFG SPDRP_MFG
DEVPKEY_Device_FriendlyName CM_DRP_FRIENDLYNAME SPDRP_FRIENDLYNAME
DEVPKEY_Device_LocationInfo CM_DRP_LOCATION_INFORMATION SPDRP_LOCATION_INFORMATION
DEVPKEY_Device_PDOName CM_DRP_PHYSICAL_DEVICE_OBJECT_NAME SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
DEVPKEY_Device_Capabilities CM_DRP_CAPABILITIES SPDRP_CAPABILITIES
DEVPKEY_Device_UINumber CM_DRP_UI_NUMBER SPDRP_UI_NUMBER
DEVPKEY_Device_BusTypeGuid CM_DRP_BUSTYPEGUID SPDRP_BUSTYPEGUID
DEVPKEY_Device_LegacyBusType CM_DRP_LEGACYBUSTYPE SPDRP_LEGACYBUSTYPE
DEVPKEY_Device_BusNumber CM_DRP_BUSNUMBER SPDRP_BUSNUMBER
DEVPKEY_Device_EnumeratorName CM_DRP_ENUMERATOR_NAME SPDRP_ENUMERATOR_NAME
DEVPKEY_Device_Security CM_DRP_SECURITY SPDRP_SECURITY
DEVPKEY_Device_SecuritySDS CM_DRP_SECURITY_SDS SPDRP_SECURITY_SDS
DEVPKEY_Device_DevType CM_DRP_DEVTYPE (SPDRP_DEVTYPE)
DEVPKEY_Device_Exclusive CM_DRP_EXCLUSIVE SPDRP_EXCLUSIVE
DEVPKEY_Device_Characteristics CM_DRP_CHARACTERISTICS SPDRP_CHARACTERISTICS
DEVPKEY_Device_Address CM_DRP_ADDRESS SPDRP_ADDRESS

プロパティ キーを使用して Windows の新しいバージョンのデバイス インスタンスのプロパティにアクセスする方法については、「デバイスインスタンスプロパティへのアクセス (Windows Vista 以降)」を参照してください。

デバイスプロパティへのアクセス

Windows Server 2003、Windows XP、Windows 2000 の CM_DRP_Xxx または SPDRP_Xxx 識別子に対応するデバイス インスタンス プロパティにアクセスするには、次の関数を使用します。