DoPkt

Send a dos packet and wait for reply (V36)

Sends a packet to a handler and waits for it to return. Any secondary return will be available in register 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 Process.pr_MsgPort for the reply and will call Process.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 file system/handler

arg1, arg2, arg3, arg4,arg5 - arguments, depend on the action, may not

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 does not work in V36. Use AllocDosObject(), PutMsg(), and WaitPort()/GetMsg() for a workaround, or you can call CreateNewProc() to start a Process to do AmigaDOS I/O for you. In V37, DoPkt() will allocate, use, and free the MsgPort required.

Callable from a Task (under V37 and above).

The prototypes in <clib/dos_protos.h> also define the functions DoPkt1() through DoPkt5() which supply only the indicated number of arguments. This allows somewhat more compact programs.

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