MoInitMediaType

 
Microsoft DirectShow 9.0

MoInitMediaType

The MoInitMediaType function initializes a media type structure.

Syntax

  HRESULT MoInitMediaType(
    DMO_MEDIA_TYPE *pmt, 
    DWORD cbFormat
);

Parameters

pmt

Pointer to an uninitialized DMO_MEDIA_TYPE structure allocated by the caller.

cbFormat

Number of bytes to allocate for the format block. Can be zero.

Return Value

Returns an HRESULT value. Possible values include the following.

Result Code Description
E_OUTOFMEMORY Insufficient memory
E_POINTER NULL pointer argument
S_OK Success

Remarks

This function allocates the format block for a DMO_MEDIA_TYPE structure. The format block is allocated on the heap. The allocated memory is not initialized. The caller must free the format block by calling the MoFreeMediaType function.

This function also sets the cbFormat and pbFormat members of the DMO_MEDIA_TYPE structure.

Requirements

  Header: Declared in Dmort.h; include Dmo.h
  Library: Msdmo.lib.

See Also