Skip to main content
IWMReaderTypeNegotiation::TryOutputProps method

The TryOutputProps method ascertains whether certain changes to the properties of an output are possible.

Syntax


HRESULT TryOutputProps(
  [in] DWORD               dwOutputNum,
  [in] IWMOutputMediaProps *pOutput
);

Parameters

dwOutputNum [in]

DWORD containing the output number.

pOutput [in]

Pointer to the IWMOutputMediaProps interface of an output media properties object.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

E_INVALIDARG

dwOutputNumber is too large.

E_UNEXPECTED

Unspecified error.

NS_E_INVALID_OUTPUT_FORMAT

Media type of object is not valid.

E_OUTOFMEMORY

Not enough memory to complete the task.

 

Remarks

This method is usually used to test different output properties to find out if they are possible; for example, to find out whether a video stream can be rendered at a resolution of 320 x 240 pixels in 16-bit color. To perform this testing, call IWMReader::GetOutputProps to retrieve an IWMOutputMediaProps interface, and alter properties by using that interface. Then test the modified object with the TryOutputProps method. If it returns S_OK, the new properties would work.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Version

Windows Media Format 7 SDK, or later versions of the SDK

Header

Wmsdkidl.h (include Wmsdk.h)

Library

Wmvcore.lib;
WMStubDRM.lib (if you use DRM)

See also

IWMOutputMediaProps Interface
IWMReaderTypeNegotiation Interface
Inputs, Streams and Outputs