AVIStreamWrite function (vfw.h)
The AVIStreamWrite function writes data to a stream.
Syntax
HRESULT AVIStreamWrite(
PAVISTREAM pavi,
LONG lStart,
LONG lSamples,
LPVOID lpBuffer,
LONG cbBuffer,
DWORD dwFlags,
LONG *plSampWritten,
LONG *plBytesWritten
);
Parameters
pavi
Handle to an open stream.
lStart
First sample to write.
lSamples
Number of samples to write.
lpBuffer
Pointer to a buffer containing the data to write.
cbBuffer
Size of the buffer referenced by lpBuffer.
dwFlags
Flag associated with this data. The following flag is defined:
| Value | Meaning |
|---|---|
|
Indicates this data does not rely on preceding data in the file. |
plSampWritten
Pointer to a buffer that receives the number of samples written. This can be set to NULL.
plBytesWritten
Pointer to a buffer that receives the number of bytes written. This can be set to NULL.
Return value
Returns zero if successful or an error otherwise.
Remarks
The default AVI file handler supports writing only at the end of a stream. The "WAVE" file handler supports writing anywhere.
This function overwrites existing data, rather than inserting new data.
The argument pavi is a pointer to an IAVIStream interface.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | vfw.h |
| Library | Vfw32.lib |
| DLL | Avifil32.dll |