AVIStreamRead
The AVIStreamRead
function reads audio, video or other data from a stream according to the stream
type.
STDAPI AVIStreamRead(
|
PAVISTREAM
pavi, |
|
|
LONG lStart, |
|
|
LONG lSamples, |
|
|
LPVOID lpBuffer, |
|
|
LONG cbBuffer, |
|
|
LONG * plBytes, |
|
|
LONG * plSamples |
|
|
); |
|
Parameters
pavi
Handle of an
open stream.
lStart
First sample
to read.
lSamples
Number of
samples to read. You can also specify the value AVISTREAMREAD_CONVENIENT to let
the stream handler determine the number of samples to read.
lpBuffer
Address of a
buffer to contain the data.
cbBuffer
Size, in
bytes, of the buffer pointed to by lpBuffer.
plBytes
Address to
contain the number of bytes of data written in the buffer referenced by lpBuffer.
This value can be NULL.
plSamples
Address to
contain the number of samples written in the buffer referenced by lpBuffer.
This value can be NULL.
Return Values
Returns zero
if successful or an error otherwise. Possible error values include the
following:
|
AVIERR_BUFFERTOOSMALL |
The buffer
size cbBuffer was smaller than a single sample of data. |
|
AVIERR_MEMORY |
There was
not enough memory to complete the read operation. |
|
AVIERR_FILEREAD |
A disk
error occurred while reading the file. |
Remarks
If lpBuffer
is NULL, this function does not read any data; it returns information about the
size of data that would be read.