CONFIGMG_Add_Res_Des

CONFIGRET CONFIGMG_Add_Res_Des(PRES_DES prdResDes, LOG_CONF lcLogConf, RESOURCEID ResourceID, PFARVOID ResourceData, ULONG ResourceLen, ULONG ulFlags)
 

Adds a resource descriptor to a logical configuration.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_FLAG, CR_INVALID_LOG_CONF, CR_INVALID_POINTER, CR_INVALID_RESOURCE_ID or CR_OUT_OF_MEMORY.

prdResDes

Address that receives a handle of the resource descriptor.

lcLogConf

The logical configuration to which the resource descriptor is added.

ResourceID

The type of the resource. This parameter can be one of the following.

ResType_DMA	DMA channels 0-3 resource
ResType_IO	Physical IO address resource
ResType_IRQ	IRQ 0-15
ResType_Mem	Physical address resource

ResourceData

Address of a resource data structure.

ResourceLen

The size, in bytes, of the structure pointed to by ResourceData.

ulFlags

Must be zero.

The new resource descriptor is added to the beginning of the logical configuration's resource-descriptor list. This means that a loop using CONFIGMG_Get_Next_Res_Des will not reveal this resource descriptor unless the loop is started after the resource descriptor has been added.

The logical configuration being modified must be either BASIC_LOG_CONF or FILTERED_LOG_CONF. Typically, BASIC_LOG_CONF is added to during device driver initialization or enumeration, whereas FILTERED_LOG_CONF is added to during a CONFIG_FILTER device-driver configuration function.

See Also

CONFIGMG_Free_Res_Des