IWMWriter::SetProfile method (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 SetProfile method specifies the profile to use for the current writing task.
Syntax
HRESULT SetProfile(
[in] IWMProfile *pProfile
);
Parameters
[in] pProfile
Pointer to an IWMProfile interface.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
Return code | Description |
---|---|
|
The method succeeded. |
|
More than one stream in the profile has the same stream number. |
|
The profile has zero streams.
The bit rate was specified as zero for a CBR-encoding mode. More than one script stream was specified. The bandwidth-sharing information is incorrect or inconsistent. |
|
The writer is not in a configurable state. |
|
For any stream:
|
|
The size specified for a language string in an audio stream is too small. |
Remarks
Calling this method removes any previously set header attribute information.
Changes to the profile object made after this method is called do not take effect until SetProfile is called again.
The maximum number of streams in a profile is 63, as defined by the constant WM_MAX_STREAMS. Another constant, WM_MAX_VIDEO_STREAMS, defines the maximum number of video streams, which is also 63.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | wmsdkidl.h (include Wmsdk.h) |
Library | Wmvcore.lib; WMStubDRM.lib (if you use DRM) |