Creative AWE32 - C3 Dasetactivereceiver; C3 Dagetactivereceiver; C3 Dasetreceiverposition

SB AWE32 Developer's Information Pack PART V 3D Positional Audio API •• 104
Copyright  Creative Technology Ltd., 1994-1996 Version 3.00
Remarks
If lpRx is the active receiver, then destruction of this receiver will cause all sound
output to cease until a new active receiver is specified.
c3daSetActiveReceiver
c3daError
PASCAL
c3daSetActiveReceiver(c3daReceiver FAR* lpRx)
Actions
Set the current active receiver. The active receiver is the receiver for which audio
spatialization algorithms are applied.
Parameters
lpRx
Specify a far pointer to a receiver object.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
Remarks
On the AWE, multiple receivers can be created; however, there can only be one active
receiver at a time.
c3daGetActiveReceiver
c3daError
PASCAL
c3daGetActiveReceiver(c3daReceiver FAR* FAR* lpRx)
Actions
Return the current active receiver.
Parameters
lpRx
Specify a far pointer to a far pointer to a receiver object.
Return
Return
c3daSUCCESS
upon success and
c3daFAILURE
otherwise.
c3daSetReceiverPosition
c3daError
PASCAL
c3daSetReceiverPosition(
c3daReceiver FAR* lpRx,
int x,
int y,
int z
)
Actions
Place a receiver in 3D space. Correspondingly, the positions of all existing emitters
are updated internally.
Parameters
lpRx
Specify a far pointer to a receiver object.
x, y, z