IDirectSound3DBuffer8::SetConeAngles
Sets the inside and outside angles of the sound projection cone for this sound buffer.
HRESULT SetConeAngles(
DWORD dwInsideConeAngle,
DWORD dwOutsideConeAngle,
DWORD dwApply
);
Parameters
- dwInsideConeAngle
- Value that specifies the inside cone angle, in degrees. This is the angle within which the sound is at its normal volume.
- dwOutsideConeAngle
- Value that specifies the outside cone angle, in degrees. This is the angle outside of which the sound is at its outside volume.
- dwApply
- Value that indicates when the setting should be applied. Must be one of the following:
- DS3D_DEFERRED
- Settings are not applied until the application calls the IDirectSound3DListener8::CommitDeferredSettings method. This allows the application to change several settings and generate a single recalculation.
- DS3D_IMMEDIATE
- Settings are applied immediately, causing the system to recalculate the 3-D coordinates for all 3-D sound buffers.
Return Values
If the method succeeds, the return value is DS_OK.
If the method fails, the return value may be DSERR_INVALIDPARAM.
Remarks
The minimum, maximum, and default cone angles are defined in Dsound.h as DS3D_MINCONEANGLE, DS3D_MAXCONEANGLE, and DS3D_DEFAULTCONEANGLE. Each angle must be in the range of 0 degrees (no cone) to 360 degrees (the full sphere). The default value is 360.
Header: Declared in dsound.h.
See Also
IDirectSound3DBuffer8::SetConeOutsideVolume, IDirectSound3DBuffer8::SetConeOrientation