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)