*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> dmedia/AUpvnew (3d)              


AUpvlist(3dm)							 AUpvlist(3dm)

NAME    [Toc]    [Back]

     AUpvlist, AUpvnew,	AUpvfree, AUpvgetmaxitems, AUpvsetvaltype,
     AUpvsetparam, AUpvsetval, AUpvgetvaltype, AUpvgetparam, AUpvgetval	-
     Audio File	parameter value	list data type

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_audioutil.h>

     AUpvlist AUpvnew(int numitems)    [Toc]    [Back]
     int AUpvfree(AUpvlist pvlist)
     int AUpvgetmaxitems(AUpvlist pvlist)
     int AUpvsetvaltype(AUpvlist pvlist, int item, int type)
     int AUpvsetparam(AUpvlist pvlist, int item, int param)
     int AUpvsetval(AUpvlist pvlist, int item, void *val_ptr)
     int AUpvgetvaltype(AUpvlist pvlist, int item, int *type_ptr)
     int AUpvgetparam(AUpvlist pvlist, int item, int *param_ptr)
     int AUpvgetval(AUpvlist pvlist, int item, void *val_ptr)

PARAMETERS    [Toc]    [Back]

	  pvlist_ptr  Pointer to an Audio File Library parameter/value list
		      data type.

	  pvlist      An Audio File Library parameter value list data type as
		      created by AUpvnew.

	  numitems    an integer representing the size to create a new

	  item	      a	integer	zero based index into an AUpvlist. The index
		      should be	non-negative and less than numitems-1.

	  type	      a	symbolic constant describing the type a	parameter.
		      Currently	supported types	are:

			   representing	values which are long

			   representing	values which are double	precision
			   floating point

									Page 1

AUpvlist(3dm)							 AUpvlist(3dm)

	  param	      is an integer which will become the parameter or the
		      parameter/value pair.

	  val	      is a pointer to a	void type.  Data will be read from
		      this pointer, interpreted	according to the type
		      associated with this entry, and stored in	the AUpvlist.

	  param_ptr   is a pointer to an integer which is filled with the
		      value of the parameter portion of	a parameter/value

	  value_ptr   is a pointer to a	void type.  Data representing the
		      value portion of a parameter/value pair is copied	to
		      this address as interpreted by this entry's type.

DESCRIPTION    [Toc]    [Back]

	       creates a new empty AUpvlist of size numitems. All entries
	       default to type AU_PVTYPE_LONG. All parameters and values are
	       initialized to zero.  The memory	pointed	to by argument
	       pvlist_ptr is set to the	new list.

	       Destroys	dynamic	memory associated with an initialized
	       AUpvlist, making	it futile for use in future calls.

	       Returns the number of list entries which	were allocated for
	       pvlist when it was created by AUpvnew.

	       Sets the	type of	the value of the item-th entry in pvlist to

	       Finds the value's type of the item-th entry in pvlist and
	       returns it in type_ptr.

									Page 2

AUpvlist(3dm)							 AUpvlist(3dm)

	       Set the value of	the item-th entry in pvlist to the value
	       stored in val_ptr.

	       Returns the value of the	item-th	entry in pvlist	in val_ptr.

	       Sets the	parameter of the item-th entry in pvlist to param.

	       Gets the	parameter of the item-th entry in pvlist and returns
	       it in param_ptr.

RETURN VALUE    [Toc]    [Back]

     On	successful completion, AUpvnew returns a valid opaque AUpvlist data
     structure.	If numitems <= 0 or there is a memory allocation error,
     AUpvnew returns a null pointer (AU_NULL_PVLIST).

     On	successful completion, all other functions return a non-negative

									PPPPaaaaggggeeee 3333
[ Back ]
 Similar pages
Name OS Title
dmMPEG1AudioHeaderGetParams IRIX get decoder parameter information from a header of any compressed MPEG1 audio data block.
AFgetmiscids IRIX get number and list of miscellaneous chunk ID's for a file, get the data type and size for a miscellaneous dat
XmTabList HP-UX Data type for a tab list
XmFontList Tru64 Data type for a font list
XmFontList HP-UX Data type for a font list
DtDtsDataTypeToAttributeList HP-UX get a list of attributes for a data type
XmFontList IRIX Data type for a font list
DtDtsFreeDataTypeNames HP-UX free a list of data type names
AFgetinstparamlong IRIX get / set a parameter list / long parameter value for an instrument configuration in an AFfilehandle structure
AFinitfilefmt IRIX initialize the audio file format type in an AFfilesetup structure
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service