デバイス インスタンスのプロパティへのアクセス (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 識別子に対応するデバイス インスタンス プロパティにアクセスするには、次の関数を使用します。