src/libsndfile.h: small code cleanups

Use more typedefs and add more comments to point from the ints to the enums.
Don't change the ints to enums for ABI reasons.