[Freemint-list] XHDI extension proposal

[Adam Klobukowski]

2017-02-19 4:46 GMT+01:00 Thorsten Otto <admin at tho-otto.de>:

> On Friday 17 February 2017 13:46:01 Adam Klobukowski wrote:
> > Bump XHDI protocol number version to 1.40
>
> Is that really needed? The existing functions do not change, and the new
> functions have to use new function numbers, anyway. If you try to call them
> with an older driver that does not support them, you will get error -32
> anyway.
>
> Bumping the version might make programs that can't be newly compiled
> complain
> about an incompatible interface.
>
>
Current version is 1.30, and you can see in the spec, that it evolved by
adding new functions, but maintaining backward compatibility. Number bump
gives API users an easy way to know what features are available, and
everyone that knows only older API should be happy too. For example,
FreeMiNT requires 1.10, and hapilly works with greater api version.


> >LONG XHGetCapacity2 (UWORD major, UWORD minor, ULONG *blocks,
>  >                              ULONG *blocksize, ULONGLONG* capacity);Like
> >XHGetCapacity, just aditional parameter, ponter to ULONGLONG where it will
> >put the capacity. Returns the same capacity if it fits 32 LONG or -1 if it
> >does not.
>
> Why use 2 output parameters for the same information?
>

To make it somehow consistent with  XHGetCapacity.

-- 
Semper Fidelis

Adam Klobukowski
adamklobukowski at gmail.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.atariforge.org/pipermail/freemint-list/attachments/20170219/3cce8282/attachment.html