Copyright © 2001-2019 MultiMedia Soft

HwMixingEnable method

Previous pageReturn to chapter overviewNext page

Remarks

 

Enables/disables Hardware mixing for playback of the sound loaded into the given player.

 

If supported by the selected output device, DirectSound tries making use of hardware acceleration in order to improve performances and decrease CPU usage: with this method you can tell DirectSound to avoid using hardware acceleration. You can know if the output device, selected for the given player, supports Hardware acceleration through a call to the HwMixingIsSupported method.

 

 

Syntax

 

[Visual Basic]

control.HwMixingEnable (

nPlayer as Integer

bEnable as enumBoolean

) as enumErrorCodes


 

[C++]

short control.HwMixingEnable (

short nPlayer

short bEnable

);


 

 

Parameter

Description

 

 

nPlayer

Number representing the zero-based index of the involved player

bEnable

Boolean value that specifies the player to enable/disable the use of Hardware mixing.

Supported values are the following:

Mnemonic constant

Value

Meaning

BOOL_FALSE

0

Doesn't use Hardware mixing

BOOL_TRUE (default)

1

Uses Hardware mixing

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The call was successful.