IWMMediaProps interface (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IWMMediaProps interface sets and retrieves the WM_MEDIA_TYPE structure for an input, stream, or output.

In the case of inputs and streams, the contents of the media type structure determine what actions the writer object will perform on the input data when writing the file. Typically, the input media type is an uncompressed type and the stream is a compressed type, so that the contents of their respective media type structures will determine the settings passed by the writer to the codec that will compress the stream.

In the case of outputs, the media type structure determines the settings used to decompress the contents of a stream. The Windows Media codecs are capable of delivering output content in a variety of formats.

The methods of IWMMediaProps are inherited by IWMVideoMediaProps, which provides access to additional settings for specifying video media types. The methods are also inherited by IWMInputMediaProps and IWMOutputMediaProps.

An instance of the IWMMediaProps interface exists for every stream configuration object, input media properties object, and output media properties object. You can retrieve a pointer to this interface by calling the QueryInterface method of any other interface in one of those objects.

Inheritance

The IWMMediaProps interface inherits from the IUnknown interface. IWMMediaProps also has these types of members:

Methods

The IWMMediaProps interface has these methods.

 
IWMMediaProps::GetMediaType

The GetMediaType method retrieves a structure describing the media type.
IWMMediaProps::GetType

The GetType method retrieves the major type of the media in the stream, input, or output described by the object to which the current IWMMediaProps interface belongs.
IWMMediaProps::SetMediaType

The SetMediaType method specifies the media type.

Requirements

Requirement Value
Target Platform Windows
Header wmsdkidl.h

See also

Input Media Properties Object

Interfaces

Output Media Properties Object

Stream Configuration Object