You know, if the only documentation that you have about interfacing to your card is source code, it would really help if your source code actually had comments.

Where do coders who don't comment come from? I've seen this far, far too often in the last five years or so. Particularly at the driver level, where it is most severely needed.