Share via


CMediaType::AllocFormatBuffer

 
Microsoft DirectShow 9.0

CMediaType::AllocFormatBuffer

The AllocFormatBuffer method allocates memory for the format block.

Syntax

  BYTE* AllocFormatBuffer(
    ULONG length
);

Parameters

length

Size required for the format block, in bytes.

Return Value

Returns a pointer to the new block if successful. Otherwise, returns NULL.

Remarks

If the method successfully allocates a new format block, it frees the existing format block. If the allocation fails, the method leaves the existing format block.

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