ASetCloseDownMode(3X) — Series 700 Only

NAME

ASetCloseDownMode − set close-down mode to destroy or complete transactions on specified connection

SYNOPSIS

#include <audio/Alib.h>

void ASetCloseDownMode (

Audio *audio,

ACloseDownMode close_mode,

long *status_return

);

DESCRIPTION

ASetCloseDownMode() sets the close-down mode to keep or destroy active and pending transactions on the connection associated with audio.

audio specifies the Audio structure associated with this connection.

close_mode specifies one of two modes: ADestroyAll causes all active and pending transactions for this connection to be stopped and destroyed when the connection is closed; associated storage is freed immediately; AKeepTransactions prevents transactions for this connection from being destroyed and allows them to complete before the close.

status_return receives the returned status of the operation unless it is set to NULL by the application.

ERRORS

If status_return is not set to NULL by the application, one of the following is returned in status_return:

0 AENoError

2 AEBadAudio

3 AEBadValue

EXAMPLES

The following example sets the close-down mode to allow transactions to complete, and sets up status to receive an error status.

Audio * audio; /* audio connection */
ACloseDownMode close_mode; /* close down mode */
long status; /* error status */
.
.
.
/* set close-down mode */
close_mode = AKeepTransactions;
ASetCloseDownMode(audio, close_mode, &status);

DEPENDENCIES

This function belongs to the Audio Library of functions that manage connections to an audio server. The audio server must run on a system that has audio hardware. To find out whether or not your system has audio hardware, refer to the hardware manual that accompanies your system.

AUTHOR

ASetCloseDownMode() was developed by HP.

Museum