OSMMsgMfaConvert(D3i2o)
OSMMsgMfaConvert --
return preserved message frame address if function fails
Synopsis
#include <i2o/i2omsg.h>
#include <i2o/common.h>
I2O_MESSAGE_FRAME *OSMMsgMfaConvert(int IopNum, U32 mfa)
Description
OSMMsgMfaConvert
passes the mfa address (from the message)
which will be an offset in the IOP's
address space (normally mapped directly to a system-space
physical address), and returns a kernel virtual address
for that mfa.
Arguments
IopNum-
The number of the IOP.
mfa-
The preserved message frame address.
Return values
OSMMsgMfaConvert
returns a valid kernel virtual address,
or NULL if the mapping fails for any reason.
NOTE:
OSMMsgMfaConvert will only correctly convert
mfas from the inbound FIFO.
Usage
OSMMsgMfaConvert
is normally called when the OSM discovers that a function has failed
and that a preserved mfa exists.
Context
All contexts
Synchronization constraints
Does not block.
Driver-defined basic locks, read/write locks, and sleep locks may be held
across calls to this function.
Hardware applicability
All
Version applicability
i2omsg: in HDK Technical Reference
2
Differences between versions
None
References
Intro(D3i2o)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005