CMediaType::ReallocFormatBuffer

  • Article
 
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