CONFIGMG_Modify_Res_Des

CONFIGRET CONFIGMG_Modify_Res_Des(PRES_DES prdResDes, RES_DES rdResDes, RESOURCEID ResourceID, PFARVOID ResourceData, ULONG ResourceLen, ULONG ulFlags)

Modifies a resource descriptor.

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

prdResDes

Address that receives the handle of the modified resource descriptor.

rdResDes

Handle of the resource descriptor to be modified.

ResourceID

One of the resource identifiers given in the ResourceId parameter of the CONFIGMG_Add_Res_Des function, ResType_All, or ResType_None. If this parameter is a resource type, the resource descriptor changes to have this type. If it is ResType_All, the previous resource type is preserved. If it is ResType_None, the resource descriptor is ignored, because arbitrators for ResType_None always succeed.

ResourceData

Address of a resource data structure.

ResourceLen

The size, in bytes, of the new resource data structure. (The new size can be different from the size before the modifications were made.)

ulFlags

Must be zero.

This function retrieves a handle to the new resource descriptor. This may or may not be the handle of the unmodified resource descriptor. The previous resource descriptor is invalid after calling this function.

See also CONFIGMG_Add_Res_Des