IWMProfileManager::LoadSystemProfile method

The LoadSystemProfile method loads a system profile identified by its index. If you do not know the index of the desired system profile, you must use IWMProfileManager::LoadProfileByID. To load a custom profile, use IWMProfileManager::LoadProfileByData.

Syntax

HRESULT LoadSystemProfile(
  DWORD      dwProfileIndex,
  IWMProfile **ppProfile
);

Parameters

dwProfileIndex

DWORD containing the profile index.

ppProfile

Pointer to a 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
S_OK
The method succeeded.
E_OUTOFMEMORY
There is not enough available memory.
E_INVALIDARG
The ppProfile parameter is NULL.

Remarks

Because there are no system profiles for the Windows Media 9 Series codecs, this method is primarily useful for obtaining version 8 system profiles that you will convert to custom profiles using the Windows Media 9 Series codecs. For more information, see Reusing Stream Configurations.

This method can be used with GetSystemProfileCount to iterate through the system profiles.

Applications must not rely on the index of a profile (used in this call and elsewhere in the SDK) being a constant. Upgrades to the Windows Media Format components can cause these indexes to change. If an application must maintain a fixed profile, it must call IWMProfile2::GetProfileID and IWMProfileManager::LoadProfileByID.

Requirements

   
Windows version Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wmsdkidl.h (include Wmsdk.h)
Library Wmvcore.lib; WMStubDRM.lib (if you use DRM)

See Also

IWMProfileManager Interface