Skip to content

Latest commit

 

History

History
53 lines (37 loc) · 1.92 KB

DoPkt.md

File metadata and controls

53 lines (37 loc) · 1.92 KB
Raw

NAME

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

SYNOPSIS

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

    LONG DoPkt(struct MsgPort *,LONG,LONG,LONG,LONG,LONG,LONG)

Links: MsgPort

FUNCTION

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().

INPUTS

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.

RESULT 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.

BUGS 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.

NOTES Callable from a task (under V37 and above).

SEE ALSO

AllocDosObject, FreeDosObject, SendPkt, WaitPkt, CreateNewProc, AbortPkt