Home / Autodocs / dos.library
NAME
- DeviceProc
-
Return the Process MsgPort of specific I/O handler
SYNOPSIS
msgport = DeviceProc( name )
D0 D1
struct MsgPort *DeviceProc(STRPTR)
D0 D1
struct MsgPort *DeviceProc(STRPTR)
FUNCTION
DeviceProc() returns the identifier of the Process which handles the device associated with the specified name. This identifier is a pointer to a MsgPort.
If no Process handler can be found, then the result is NULL. If the name refers to an assign, then a directory Lock is returned by IoErr(). This Lock should not be UnLock()ed or Examine()ed (if you wish to do so, DupLock() it first).
If no Process handler can be found, then the result is NULL. If the name refers to an assign, then a directory Lock is returned by IoErr(). This Lock should not be UnLock()ed or Examine()ed (if you wish to do so, DupLock() it first).
INPUTS
- name
-
Pointer to a null-terminated string of the file, directory, volume or device in question. Names such as ":", "", "RAM:Disk.info" and "DF0:" are all suitable.
RESULT
- msgport
-
Pointer to the MsgPort associated with the respective file system device or NULL for failure. Call IoErr() to find out why the file system could not be found.
BUGS
In V36, if you try to DeviceProc() something relative to an assign made with AssignPath(), it will fail. This is because there's no way to know when to unlock the Lock. If you're writing code for V36 or later, it is highly advised you use GetDeviceProc() instead, or make your code conditional on V36 to use GetDeviceProc()/ FreeDeviceProc().