1. Community Forum
  2. AWE Core
  3. awe_fwPacketExecuteArray() calling signature for 6.17.04

awe_fwPacketExecuteArray() calling signature for 6.17.04

4 posts / 0 new
Log in or register to post comments
Last post
Tue, 10/09/2018
1:00pm
Steve Stearns
#1
Top
#1
awe_fwPacketExecuteArray() calling signature for 6.17.04

Greetings,

I'm successfully building and running a compiled-in awe model but...

The 6.17.04 documentation calls out: 
INT32 awe_fwPacketExecuteArray(AWEInstance *pAWE, UINT32 *array, UINT32 arraySize);

Whereas the applicable header file (PlatformAPI.h) calls out:
INT32 awe_fwPacketExecuteArray(AWEInstance *pAWE, const UINT32 *pCommands, UINT32 arraySize, UINT32 *pPos);

So I just created a UINT32 call Pos and passed it's location and it seems to work.

I think it would be nice to actually know its intended usage though...

Does anyone know?

Thanks,

Steve.

Tue, 10/09/2018
3:39pm
Andrew
Top

Hello Steve,

The argument *pPos is the position in the array where an error occurred in parsing. Sorry about the lack of documentation for that...We are working to keep our documents up to date.  

Tue, 10/09/2018
3:45pm
Steve Stearns
Top

Cool.  Good to know (and hope I never need it!  :-) )

Thanks,

Steve.

Tue, 10/09/2018
3:48pm
Steve Stearns
Top

btw: If we aren't currently using "Pos" and, instead, pass a NULL pointer - is the code designed to be well behaved?  (not that I would do this until it's documented but it seems an appropriate behavior...).