CONFIGMG_Add_Empty_Log_Conf

CONFIGRET CONFIGMG_Add_Empty_Log_Conf(PLOG_CONF plcLogConf, DEVNODE dnDevNode, PRIORITY Priority, ULONG ulFlags)
 

Creates an empty logical configuration. This configuration has no resource descriptor.

plcLogConf
Address that receives the handle of the logical configuration.
dnDevNode
Address of a device node. This address is typically retrieved by a call to CONFIGMG_Locate_DevNode or CONFIGMG_Create_DevNode.
Priority
Priority of the logical configuration. This parameter can be one of the following values.
LCPRI_FORCECONFIG Coming from a forced config.
LCPRI_BOOTCONFIG Coming from a boot config.
LCPRI_HARDWIRED Like VPICD's IO range.
LCPRI_DESIRED Preferable set (better performance).
LCPRI_NORMAL Workable (acceptable performance).
LCPRI_SUBOPTIMAL Not desired but will work (like PIO).
LCPRI_RESTART Need to restart Windows.
LCPRI_REBOOT Need to reboot Windows.
LCPRI_POWEROFF Need to shutdown Windows.
LCPRI_HARDRECONFIG Need to change a jumper.

ulFlags
Either BASIC_LOG_CONF or FILTERED_LOG_CONF, combined with either PRIORITY_EQUAL_FIRST or PRIORITY_EQUAL_LAST.
BASIC_LOG_CONF Specifies the requirements list.
FILTERED_LOG_CONF Specifies the filtered requirements list.
PRIORITY_EQUAL_FIRST Same priority, new one is first.
PRIORITY_EQUAL_LAST Same priority, new one is last.

Note  Calling CONFIGMG_Add_Empty_Log_Conf or CONFIGMG_Free_Log_Conf from within a CONFIGMG_Get_First_Log_Conf/CONFIGMG_Get_Next_Log_Conf loop may have unwelcome side effects. Drivers should end the loop before adding or freeing a logical configuration and start it again when the operation is finished.

See Also

CONFIGMG_Create_DevNode, CONFIGMG_Free_Log_Conf, CONFIGMG_Get_First_Log_Conf, CONFIGMG_Get_Next_Log_Conf, CONFIGMG_Locate_DevNode