Re: Documentation confusing
Re: Documentation confusing
- Subject: Re: Documentation confusing
- From: Jeff Moore <email@hidden>
- Date: Wed, 10 Dec 2003 16:01:13 -0800
Yes, adding a "differs" there does make it read better. I changed the
comment in the code. Thanks!
On Dec 10, 2003, at 3:28 PM, Jens Bauer wrote:
Hi Jeff,
Thanks for your reply. :)
On Wednesday, Dec 10, 2003, at 20:59 Europe/Copenhagen, Jeff Moore
wrote:
What this paragraph is saying is that an IOProc should set the value
of the mDataByteSizeField of each AudioBuffer in the AudioBufferList
that olds the output data to indicate how much data was written
there. The "On input" sentence is saying that this field is already
filled out to be the size of the buffer when the IOProc is called and
consequently won't need to be changed, since the IOProc is
responsible for filling the whole buffer. The time when it would need
to be changed is for certain compressed formats like the VBR form of
AC-3 or what have you.
On Dec 10, 2003, at 5:02 AM, Jens Bauer wrote:
Looking in CoreAudio/AudioHardware.h, I find the paragraph (right
above AudioDeviceIOProc):
// On exiting, the IOProc should set the mDataByteSize field of each
AudioBuffer
// (if any) in the output AudioBufferList. On input, this value is
set to the
// size of the buffer, so it will only need to be changed for cases
where
// the number of bytes for the buffer size
(kAudioDevicePropertyBufferFrameSize)
// of the IO transaction. This may be the case for compressed
formats like AC-3.
Reading from "On input, ..." definitely sounds confusing to me;
isn't something missing here ?
I get it now; I think my eyes just got stuck on this sentence, because
of a missing word. (I can't help it!)
-If I understand it correctly, the word "differs" should be appended
to the sentence right after "the IO transaction" ?
Love,
Jens
--
Jeff Moore
Core Audio
Apple
_______________________________________________
coreaudio-api mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/coreaudio-api
Do not post admin requests to the list. They will be ignored.