AXFXDelayExpSettingsUpdateDpl2

C Specification

#include <revolution.h>
#include <revolution/axfx.h>

BOOL AXFXDelayExpSettingsUpdateDpl2 (AXFX_DELAY_EXP_DPL2 *delay);

Arguments

delay Pointer to an initialized AXFX_DELAY_EXP_DPL2 structure.

Return Values

TRUE if successful; FALSE if a parameter is out of bounds or if memory allocation fails.

Description

The AXFXDelayExpSettingsUpdateDpl2 function is used when changing parameters of the initialized Dolby Pro Logic II (DPL2) version of the Delay Expansion (= AXFX_DELAY_EXP_DPL2 structure). When this function is called, the current DPL2 version of Delay Expansion is shut down and then reinitialized based on new user parameters. Memory is not freed and re-allocated during this process.

Caution is required when using this function to change the AXFX_DELAY_EXP_DPL2 structure's user parameter delay. Because memory is not freed and re-allocated, delay cannot be changed to a value greater than maxDelay. If it is necessary to change maxDelay, please use the AXFXDelayExpSettingsDpl2 function.

Revision History

2007/08/10 Initial version.