Microsoft DirectX 8.0 (Visual Basic) |
Retrieves an object in the audio path of the buffer. Typically this method is used to retrieve an object representing a sound effect in a buffer or DMO.
object.GetObjectinPath( _ guidFX As String, _ lIndex As Long, _ iidInterface As String _ ) As Unknown
Returns an object representing the effect.
If the method fails, an error is raised. Possible values for Err.Number include DSERR_OBJECTNOTFOUND.
The following table shows the standard effects objects that can be retrieved from a buffer on which the effects have been set.
guidFX | iidInterface | Returned object |
---|---|---|
DSFX_STANDARD_CHORUS | IID_DirectSoundFXChorus | DirectSoundFXChorus8 |
DSFX_STANDARD_COMPRESSOR | IID_DirectSoundFXCompressor | DirectSoundFXCompressor8 |
DSFX_STANDARD_DISTORTION | IID_DirectSoundFXDistortion | DirectSoundFXDistortion8 |
DSFX_STANDARD_ECHO | IID_DirectSoundFXEcho | DirectSoundFXEcho8 |
DSFX_STANDARD_FLANGER | IID_DirectSoundFXFlanger | DirectSoundFXFlanger8 |
DSFX_STANDARD_GARGLE | IID_DirectSoundFXGargle | DirectSoundFXGargle8 |
DSFX_STANDARD_I3DL2REVERB | IID_DirectSoundFXI3DL2REVERB | DirectSoundFXI3DL2Reverb8 |
DSFX_STANDARD_PARAMEQ | IID_DirectSoundFXParamEq | DirectSoundFXParamEq8 |
DSFX_STANDARD_WAVES_REVERB | IID_DirectSoundFXWavesReverb | DirectSoundFXWavesReverb8 |
Any DMO that has been set on a buffer by using DirectSoundSecondaryBuffer8.SetFX can be retrieved, even it has not been allocated resources.