Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The TDx_Sound::SetCooperativeLevel method will set the applications cooperative level for the sound device.
DSSCL_PRIORITY is the recommended cooperative level.
The cooperative level must be set by an application before its buffers can be played.
If the method call fails, the OnError event will be triggered with one of the following values:
DSERR_ALLOCATED
DSERR_INVALIDPARAM
DSERR_UNINITIALIZED
DSERR_UNSUPPORTED
- Parameters
HWnd
The HWnd parameter defines the applications window handle.
When also using TDx_Draw, this window handle must be the same as that used in TDx_Draw::SetCooperativeLevel().
Level
The Level parameter defines flags indicating the priority level being requested.
The described effect applies when the flag is set.
-
DSSCL_EXCLUSIVE
The application has exclusive level access to the sound device.
All DSSCL_PRIORITY level privileges apply plus when the application has the input focus it will be the only one audible.
DSSCL_NORMAL
The application has normal level access to the sound device.
The format of the primary buffer may not be changed, sound output is restricted to the default 8-bit sound format.
DSSCL_PRIORITY
The application has priority level access to the sound device.
Priority level access allows the use of TDx_SoundBuffer::SetFormat() and TDx_SoundBuffer::Compact() methods.
DSSCL_WRITEPRIMARY
The application has write access to the primary sound buffers.
No secondary sound buffers can be played.
This cooperative level cannot be set if DSCAPS_EMULDRIVER is set in TDSCaps::Flags.
- See Also
- Top
TDx_Sound_Library v2.00 Component Reference
|
|
|
[ TDx_Sound::SetCooperativeLevel() ] [ next: SetSpeakerConfig() ] [ prev: Internal_DSEnumerateCallback() ] public:
virtual bool __fastcall SetCooperativeLevel( HWND pHWnd, dword pLevel );
TDX_SOUND::SETCOOPERATIVELEVEL()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|