NAME

AuInvokePlay − initiate a widget play operation

SYNOPSIS

#include <audio/Play.h>

extern void AuInvokePlay(Widget widget);

DESCRIPTION

AuInvokePlay() initiates a widget play operation.  A play widget must be created before it can be invoked.  If the application calls AuInvokePlay() more than once, set up callbacks for AuNstopped and AuNcompleted.  Use these notifications to avoid overlapping with a transaction that is still active from a prior AuInvokePlay(). 

widget the name of a play widget. 

ERRORS

AuInvokePlay() does not return an error status. 

DEPENDENCIES

This function belongs to the Audio Application Program Interface widget library.  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

AuInvokePlay() was developed by HP. 

SEE ALSO

AtAddCallback(), AtInitialize(), AtRemoveCallback, AuCreatePlay(), AuCreateRecord(), AuInvokeRecord(), AuPlayWidget, AuRecordWidget, AuSaveFile(). 

Using the Audio Application Program Interface.

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995