Wimp_GetWindowInfo documentation

The documentation of Wimp_GetWindowInfo could usefully be improved.

On entry bit 0 of the address of the buffer is described as “If set, return just window header (without icons)”.

This is actually useful, but needs explanation.

The required buffer size for this version of the call is 92 bytes.
It returns the window block up to AND INCLUDING the icon count, in the word at byte 88 of the returned buffer. (Determined by testing, this should be documented). This allows the user to calculate the size of buffer needed for the full call, i.e. with bit 0 clear.

The buffer size is 92 + 32 * icon count. In cases where the icon count is not known in advance, the full call has the potential to corrupt memory, as was mentioned this week in a thread elsewhere on the forum.

The documentation of Wimp_GetWindowInfo could usefully be improved

I’ve updated the Wimp_GetWindowInfo entry on the Wiki for you.

Feel free to edit and add addition info if you feel it needs more detail.