Functionality Module Dispatch Switcher Functions

This section describes the firmware message dispatch management functions. There are two types of custom message dispatch functions and a FM designer needs to choose one and only one for their own FM. FM designers should use the type of dispatch function that best suits their source code.

When the FM registers its dispatch function it needs to specify the FMID of the current FM. The function GetFMID() is provided to allow the FM writer to easily get this value.

The Functionality Module Dispatch Switcher section contains the following functions:

>FMSW_RegisterRandomDispatch

>FMSW_RegisterStreamDispatch

Random Access Dispatch Function:

This is the older schema best suited for PTK style FMs. It allows the FM designer full random access to the contents of the request buffer and the response buffer.

Streaming Access Dispatch Function:

This is the newer schema that is used by the sample FMs. It allows the FM designer to read from the request buffer and write to the response buffer without needing to keep track of the current read and write points.

The read and write functions will provide automatic Endian conversion to integer values.