IOCTL_FARC_GET_NETMAP
Description:
retrieve current netmap
Parameters:
Parameter | Type | Description |
Input | ||
return condition (optional) |
struct ARCNET_NETMAP | If NULL the function returns result immediately If ARCNET_NETMAP was specified, then the driver compares the input netmap with the real netmap and returns results only if differences are detected or the specified timeout was elapsed. The timeout is specified in 10ms units and has 1 special cases:
|
Output | ||
current net map | struct ARCNET_NETMAP | the number of interrupts, that occured since the last initialization of the ARCNET-adapter |
Possible errors (see also Error codes):
E_FARC_ABORT
E_FARC_NOT_INITED,
E_FARC_EXCESSIVE_RECON,
E_FARC_BUFFER_TOO_SMALL,
E_FARC_NETMAP_PENDING,
E_FARC_NETMAP_NO_CHANGE
Remarks:
Only one request of this call can be pending, otherwise an error will be returned.
A pending request will be cancelled if IOCTL_FARC_DEINIT is performed.
In case of SH ARC-USB this functions returns result immediately due to the design limitations.
Requirements:
this function is supported by:
- all ARCNET adapters with COM2002x controller and SOHARD URAW API driver;
- SH ARC-USB since driver v4.4.
Notes:
1) This feature allows only simple
and rudimentary netmap detection. The driver may NOT detect glitches in
the netmap. Furthermore this funtion may return "ghost nodes". You
should only look at that nodes that are set in the previous call to
IOCTL_FARC_NETMAP_SETTINGS.
2) This feature does not supported by SH ARC-66
3)If you need a safe and reliable node/netmap detection,
use SH ARCALYZER.
Example:
Note, that the following example is only a fragment. It is recommended,
that the driver is opened in asynchronous mode and a handle to the driver is available.
See also:
DeviceIoControl()
IOCTL_FARC_NETMAP_SETTINGS
IOCTL_FARC_DEINIT
ARCNET_NETMAP
Back to Programming Guide | Contact | Copyright and Disclaimer |