|
IAVIStream::Read
The Read method reads data from a stream and copies it to an application-defined
buffer. If no buffer is supplied, it determines the buffer size needed to retrieve
the next buffer of data. Called when an application uses the AVIStreamRead function.
HRESULT Read(
PAVISTREAM ps,
|
| LONG lStart,
|
| LONG lSamples,
|
| LPVOID lpBuffer,
|
| LONG cbBuffer,
|
| LONG *plBytes,
|
| LONG *plSamples
|
| );
|
|
Parameters
ps
Address of the interface to a stream.
lStart
Starting sample or frame number to read.
lSamples
Number of samples to read.
lpBuffer
Address of the application-defined buffer to contain the stream data. You can
also specify NULL to request the required size of the buffer. Many applications
precede each read operation with a query for the buffer size to see how large
a buffer is needed.
cbBuffer
Size, in bytes, of the buffer specified by lpBuffer.
plBytes
Address to contain the number of bytes read.
plSamples
Address to contain the number of samples read.
Return Values
Returns AVIERR_OK if successful or AVIERR_BUFFERTOOSMALL if the buffer is not
large enough to hold the data. If successful, Read also returns either a buffer of data with the number of frames (samples)
included in the buffer or the required buffer size, in bytes.
Remarks
For handlers written in C++, Read has the following syntax:
HRESULT Read(LONG lStart, LONG lSamples,
LPVOID lpBuffer, LONG cbBuffer,
LONG *plBytes, LONG *plSamples);
See Also
AVIStreamRead
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Programmer's Reference (win32.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
