CONFIGMG_Add_Empty_Log

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.

Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_DEVNODE, CR_INVALID_FLAG, CR_INVALID_PRIORITY, CR_INVALID_POINTER or CR_OUT_OF_MEMORY.

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