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

	DoPkt -- Send a dos packet and wait for reply (V36)

	result1 = DoPkt(port,action,arg1,arg2,arg3,arg4,arg5)
	D0               D1    D2    D3   D4   D5   D6   D7


	Sends a packet to a handler and waits for it to return.  Any secondary
	return will be available in D1 AND from IoErr().  DoPkt() will work
	even if the caller is an exec task and not a process; however it will
	be slower, and may fail for some additional reasons, such as being
	unable to allocate a signal.  DoPkt() uses your pr_MsgPort for the
	reply, and will call pr_PktWait.  (See BUGS regarding tasks, though).

	Only allows 5 arguments to be specified.  For more arguments (packets
	support a maximum of 7) create a packet and use SendPkt()/WaitPkt().

	port    - pr_MsgPort of the handler process to send to.
	action  - the action requested of the filesystem/handler
	arg1, arg2, arg3, arg4,arg5 - arguments, depend on the action, may not
		   be required.

	result1 - the value returned in dp_Res1, or FALSE if there was some
		  problem in sending the packet or recieving it.
	result2 - Available from IoErr() AND in register D1.

	Using DoPkt() from tasks doesn't work in V36. Use AllocDosObject(),
	PutMsg(), and WaitPort()/GetMsg() for a workaround, or you can call
	CreateNewProc() to start a process to do Dos I/O for you.  In V37,
	DoPkt() will allocate, use, and free the MsgPort required.

	Callable from a task (under V37 and above).

	AllocDosObject(), FreeDosObject(), SendPkt(), WaitPkt(),
	CreateNewProc(), AbortPkt()

[Back to Amiga Developer Docs]