System-Defined Driver Rank Constants (Windows Server 2003, Windows XP, and Windows 2000)

The following system-defined constants are defined in Setupapi.h. These constants can be used to extract or compare driver rank values on Windows Server 2003, Windows XP, and Windows 2000:

  • DRIVER_HARDWAREID_RANK
    The value of this constant is the worst identifier-list-position score for any type of identifier match. An identifier-list-position score is always less than or equal to this constant. This value is also the worst possible rank of a signed driver that has a hardware ID match. This constant can be used as a bitmask to extract only the identifier-list-position score from a driver rank. To extract the identifier-list-position score from a driver rank, perform a bitwise AND between the rank and DRIVER_HARDWAREID_RANK.

  • DRIVER_COMPATID_RANK
    The value of this constant is the worst possible rank of a signed driver. A signed driver will always have a rank less than or equal to this constant. This constant can be used as a bitmask to extract the identifier score from a driver rank. To extract the identifier score from a driver rank, perform a bitwise AND between the rank and DRIVER_COMPATID_RANK.

  • DRIVER_UNTRUSTED_RANK
    The value of this constant is the best possible rank for a hardware ID match for an unsigned driver that is installed by an INF DDInstall section that has an .nt platform extension. The rank of an unsigned driver for any match type is always equal or greater than this constant. This bitmask can be used to determine whether a driver rank indicates a driver is signed or unsigned. To determine whether a driver is signed, perform a bitwise AND between this bitmask and the rank of the driver, and if the result is zero, the driver is signed. Otherwise, the driver is unsigned.

  • DRIVER_UNTRUSTED_HARDWAREID_RANK
    The value of this constant is the worst possible rank for a hardware ID match for an unsigned driver that is installed by an INF DDInstall section that has an .nt platform extension. A driver rank, less than or equal to this constant and greater than DRIVER_UNTRUSTED_RANK, indicates that the driver is unsigned, the identifier match type is a hardware ID match, and the driver is installed by an INF DDInstall section that has an .nt platform extension.

  • DRIVER_UNTRUSTED_COMPATID_RANK
    The value of this constant is the worst possible rank for a compatible ID match for unsigned driver that is installed by an INF DDInstall section that has an .nt platform extension. A driver rank, less than or equal to this constant and greater than DRIVER_UNTRUSTED_HARDWAREID_RANK, indicates that the identifier match type is a compatible ID match, the driver is unsigned, and the driver is installed by an INF DDInstall section that has an .nt platform extension.

  • DRIVER_W9X_SUSPECT_RANK
    The value of this constant is the best possible rank for a hardware ID match for an unsigned driver that is not installed by an INF DDInstall section that has an .nt platform extension. A driver rank, greater than or equal to this constant and less than or equal to DRIVER_W9X_SUSPECT_HARDWAREID_RANK, indicates that the driver is unsigned, the identifier match type is a hardware ID match, and that the driver is not installed by an INF DDInstall section that has an .nt platform extension,

  • DRIVER_W9X_SUSPECT_HARDWAREID_RANK
    The value of this constant is the worst possible rank for a hardware ID match for an unsigned driver that is not installed by an INF DDInstall section that has an .nt platform extension. A driver rank, less than or equal to this constant and greater than DRIVER_W9X_SUSPECT_RANK, indicates that the driver is unsigned, the identifier match type is a hardware ID match, and that the driver is not installed by an INF DDInstall section that has an .nt platform extension.

  • DRIVER_W9X_SUSPECT_COMPATID_RANK
    The value of this constant is the worst possible rank for an unsigned driver that is not installed by an INF DDInstall section that has an .nt platform extension. A driver rank, less than or equal to this constant and greater than DRIVER_W9X_SUSPECT_HARDWAREID_RANK, indicates that the driver is unsigned, that the identifier match type is a compatible ID match, and that the driver is not installed by an INF DDInstall section that has an .nt platform extension.

For more information about driver ranking, see How Windows Ranks Drivers (Windows Server 2003, Windows XP, and Windows 2000).

For more information about the .nt extension, see Creating INF Files for Multiple Platforms and Operating Systems.

 

 

Send comments about this topic to Microsoft