CMediaType::ReallocFormatBuffer
Microsoft DirectShow 9.0 |
CMediaType::ReallocFormatBuffer
The ReallocFormatBuffer method reallocates the format block to a new size.
Syntax
BYTE* ReallocFormatBuffer( ULONG length );
Parameters
length
New size required for the format block, in bytes. Must be greater than zero.
Return Value
Returns a pointer to the new block if successful. Otherwise, returns either a pointer to the old format block, or NULL.
Remarks
This method allocates a new format block. It copies as much of the existing format block as possible into the new format block. If the new block is smaller than the existing block, the existing format block is truncated. If the new block is larger, the contents of the additional space are undefined. They are not explicitly set to zero.
The method updates the cbFormat and pbFormat members of the AM_MEDIA_TYPE structure.
Requirements
** Header:** Declared in Mtype.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also