Home / Autodocs / expansion.library
NAME
- MakeDosNode
-
construct AmigaDOS data structures that a disk needs
SYNOPSIS
deviceNode = MakeDosNode( parameterPkt )
D0 A0
struct DeviceNode * MakeDosNode( void * );
D0 A0
struct DeviceNode * MakeDosNode( void * );
FUNCTION
This routine manufactures the data structures needed to enter an AmigaDOS disk device into the system. This consists of a DeviceNode, a FileSysStartupMsg, a DosEnvec (disk environment vector), and up to two null-terminated BCPL strings. See the <dos/dosextens.h> and <dos/filehandler.h> 'C' header files for more information.
MakeDosNode() is a convenience function which will allocate all the memory it needs, and then link the various structure together. While you could achieve the same effect by performing the individual setup and initialization work, MakeDosNode() does it all for you.
MakeDosNode() is a convenience function which will allocate all the memory it needs, and then link the various structure together. While you could achieve the same effect by performing the individual setup and initialization work, MakeDosNode() does it all for you.
- Note:
-
MakeDosNode() will always create a type DLT_DEVICE DosList, with a mass storage device driver attached to it. See <dos/dosextens.h> and the dos.library/MakeDosEntry() documentation.
INPUTS
- parameterPkt
-
a longword array containing all the information needed to initialize the data structures. Normally, a designated data structure would have been provided for this, but the variable length of the packet contents prevented it. The two strings are null-terminated strings, like all other exec strings.
longword description
-------- -----------
0 string with AmigaDOS handler name
1 string with exec device name
2 unit number (for OpenDevice)
3 flags (for OpenDevice)
4-n DosEnvec (see <dos/filehandler.h>)
RESULT
- deviceNode
-
pointer to initialize device node structure, or null if there was not enough memory. You may need to change certain fields before passing the DeviceNode to AddDosNode().
EXAMPLE
/* set up a 3.5" Amiga format floppy drive for unit 1 */
#include <dos/filehandler.h>
char execName[] = "trackdisk.device";
char dosName[] = "df1";
ULONG parmPkt[] = {
};
struct DeviceNode *node;
node = MakeDosNode( parmPkt );
#include <dos/filehandler.h>
char execName[] = "trackdisk.device";
char dosName[] = "df1";
ULONG parmPkt[] = {
(ULONG) dosName,
(ULONG) execName,
1, /* unit number */
0, /* OpenDevice() flags */
/* here is the environment block (DosEnvec) */
DE_DOSTYPE, /* table upper bound */
512 / 4, /* # longwords in a block */
0, /* sector origin -- unused */
2, /* number of surfaces */
1, /* secs per logical block -- leave as 1 */
11, /* blocks per track */
2, /* reserved blocks -- 2 boot blocks */
0, /* unused, but must be 0 */
0, /* interleave */
0, /* lower cylinder */
79, /* upper cylinder */
5, /* number of buffers */
MEMF_ANY|MEMF_PUBLIC, /* type of memory for buffers */
0x00200000, /* largest transfer size */
0x7ffffffe, /* address mask */
0, /* boot priority */
0x444f5300, /* dostype: 'DOS\0' */
(ULONG) execName,
1, /* unit number */
0, /* OpenDevice() flags */
/* here is the environment block (DosEnvec) */
DE_DOSTYPE, /* table upper bound */
512 / 4, /* # longwords in a block */
0, /* sector origin -- unused */
2, /* number of surfaces */
1, /* secs per logical block -- leave as 1 */
11, /* blocks per track */
2, /* reserved blocks -- 2 boot blocks */
0, /* unused, but must be 0 */
0, /* interleave */
0, /* lower cylinder */
79, /* upper cylinder */
5, /* number of buffers */
MEMF_ANY|MEMF_PUBLIC, /* type of memory for buffers */
0x00200000, /* largest transfer size */
0x7ffffffe, /* address mask */
0, /* boot priority */
0x444f5300, /* dostype: 'DOS\0' */
struct DeviceNode *node;
node = MakeDosNode( parmPkt );