awe_fwPacketExecuteArray() calling signature for 6.17.04

4 posts / 0 new
Last post
Steve Stearns
Offline
Last seen: 2 months 1 week ago
Joined: 05/09/2017 - 10:14am
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.

Andrew
Offline
Last seen: 1 week 4 days ago
Joined: 04/12/2018 - 9:25am

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.  

Steve Stearns
Offline
Last seen: 2 months 1 week ago
Joined: 05/09/2017 - 10:14am

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

Thanks,

Steve.

Steve Stearns
Offline
Last seen: 2 months 1 week ago
Joined: 05/09/2017 - 10:14am

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...).