[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
	CreateMsgPort - Allocate and initialize a new message port  (V36)

   SYNOPSIS
	CreateMsgPort()

	struct MsgPort * CreateMsgPort(void);

   FUNCTION
	Allocates and initializes a new message port.  The message list
	of the new port will be prepared for use (via NewList).  A signal
	bit will be allocated, and the port will be set to signal your
	task when a message arrives (PA_SIGNAL).

	You *must* use DeleteMsgPort() to delete ports created with
	CreateMsgPort()!

   RESULT
	MsgPort - A new MsgPort structure ready for use, or NULL if out of
		memory or signals.  If you wish to add this port to the public
		port list, fill in the ln_Name and ln_Pri fields, then call
		AddPort().  Don't forget RemPort()!

   SEE ALSO
	DeleteMsgPort(), exec/AddPort(), exec/ports.h, amiga.lib/CreatePort()