| C T L _ D E V M O U N T ( )
| | | | | SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English AMIGA - CTL_#?
----------------------------------------------------------------------------
NAME
ctl_devmount() - Allows to interpret mountlists.
SYNOPSIS
res = ctl_devmount(mlfile, mlpatt, range,
flags, cbdata, cbcode);
LONG ctl_devmount(UBYTE *, UBYTE *, LONG,
ULONG, void *, LONG (*)(struct nfo_sml_cb *));
FUNCTION
This function allows to perform various ops on
mountlist entries using callback. Its purpose is
to mount devices using 'dmt_mountcb()' callback
but it can be used to do something else too.
INPUTS
mlfile - Mountlist filename.
mlpatt - Device(handler) name. Standard AmigaOS
patterns are allowed here. Presence or
lack of colon(s) is fine.
range - Boundary check. See 'nfo_grepml()' for
more details.
flags - Flags passed to the callback.
cbdata - Private user data pointer.
cbcode - Callback pointer.
RETURNS
See 'nfo_grepml()' for possible output.
BASES
SysBase, DOSBase, IconBase
NOTES
See 'nfo_grepml()' for more details. Yes, this
function wraps it.
If you need output from under the callback per
entry, then wrap 'dmt_mountcb()'. Var. 'cbdata'
will be mapped to 'sc->sc_userdata'.
Note! Even erroneous/bogus mountlist entries
will be passed to the callback, so you really
must inspect 'sc->sc_gerror' and decide what
to do.
Dont forget that you must copy 'sc' structure in
the callback to retain its contents during scan.
In other words if you want to write your own CB
that mounts devices then you must make a copy of
'sc' so it can live along with 'DeviceNode'.
To copy 'sc' use 'mem_copysmlcb()', it will make
sure that every member/pointer is long aligned.
SEE ALSO
EXAMPLE
None.
BUGS
None known.
----------------------------------------------------------------------------
| |
| |