| On entry: |
|
||||||
| On exit: | - | ||||||
| Interrupts: | Interrupt status is unaltered Fast interrupts are enabled |
||||||
| Processor Mode: | Processor is in SVC mode | ||||||
| Re-entrancy: | SWI is reentrant | ||||||
| Use: | This call sets the parameter
specified by R1 to be a pointer to the zero-terminated string specified by
R2. Ensure this string buffer exists across the CallWin32_WithPars as it
will be filled in with whatever modifications the Win32 function made. Note that the string buffer's size should be a multiple of 4 bytes (this is because the memory copying routine copies 4 bytes at a time for efficiency) and hence on API return the buffer will be overwritten to string length rounded up to the next 4 byte boundary. Not fulfilling this will cause data corruption. Lastly, if you are receiving a much larger string than you are sending, use CallWin32_ParsAddMemBlk passing the length of the string you expect to receive otherwise not all of the string will be retrieved. Ensure you use the ANSI variant of any Win32 API you call as RISC-OS does not support Unicode. |
||||||
| Related SWIs: | CallWin32_ParsInit (SWI &C1002), CallWin32_ParsAddInt32 (SWI &C1003),CallWin32_ParsAddInt16 (SWI &C1004), CallWin32_ParsAddInt8 (SWI &C1005), CallWin32_ParsAddMemBlk (SWI &C1006), CallWin32_WithPars (SWI &C1008) |