Hardware Profile Services

A hardware profile is a set of information that defines the hardware present in the system. Hardware profiles are typically used in docking systems in which the number and type of devices may be different with each docking station. The typical docking system has one hardware profile for each docking station and one for when it is not docked.

When the system boots, docks or undocks, each enumerator reenumerates its hardware, determining what is available and creating or removing device nodes to reflect that availability. The enumerator uses the hardware-profile services to create and maintain the hardware profiles for the system. There are these services:

Service

Description

CONFIGMG_Fail_Change_Config

Cancels preparation for changing the current Hardware Profile.

CONFIGMG_Get_HW_Prof_Flags

Retrieves the configuration-specific configuration flags for a devnode/hardware profile combination.

CONFIGMG_Recompute_HW_Prof

Calculates the current hardware profile based on the docking station identifier and the docking station serial ID.

CONFIGMG_Set_HW_Prof

Sets the current hardware profile.

CONFIGMG_Set_HW_Prof_Flags

Sets the configuration-specific configuration flags for a devnode/hardware profile combination.


The hardware-profile flags apply to each device node and identify whether the device node should be created for a given profile. You can get and set the flags by using the CONFIGMG_Get_HW_Prof_Flags and CONFIGMG_Set_HW_Prof_Flags services.