Share via


WMEncProfileManager.GetDetailsString

Windows Media Encoder SDK banner art

The GetDetailsString method retrieves a string containing the details of a specific profile.

Syntax

String = WMEncProfileManager.GetDetailsString(strProfileName, lcid)

Parameters

strProfileName

[in]  String containing the name of the profile.

lcid

[in]  Long containing the locale ID identifying the language that appears in the Profile Manager. If this is 0, the locale ID defaults to English.

Return Values

This method returns a String containing profile details.

If this method fails, it returns an error number.

Number Description
0x80070057 The string containing the profile name cannot be empty.

Remarks

The output string identifies the total number of streams that will be produced by Windows Media Encoder, the bit rate of each, and the specific codecs used. It also indicates the default size, in pixels, of the output video and the number of audio channels produced. The GetDetailsString method does not create a Profile Manager dialog box.

Example Code

' Create a WMEncProfileManager object.
Dim ProfileMgr As WMEncProfileManager
Set ProfileMgr = New WMEncProfileManager

Dim sLastProfile As String
Dim sProfileDirectory As String
Dim sDetailsString As String

' Display the dialog box that lists the profiles. Because you
' are calling WMEncProfileListEx rather than WMEncProfileList
' and have indicated that a new profile is audio-only, if you
' bring up the New profile dialog box, only the audio check box
' will be selected.
ProfileMgr.WMEncProfileListEx WMENC_FILTER_AV, WMENC_FILTER_A, 0

' Display the New Profile dialog box. If you supply the name of an
' existing profile, the new profile will be a copy of that one.
ProfileMgr.WMEncProfileEdit "Windows Media Video 8 for Local Area Network (384 Kbps)", WMENC_FILTER_AV, 0

' Retrieve a string containing the details of a specific profile.
sDetailsString = ProfileMgr.GetDetailsString("Windows Media Video 8 for Local Area Network (384 Kbps)", 0)

' Retrieve the name of the last profile created during the current
' encoding session.
sLastProfile = ProfileMgr.LastCreatedProfile

' Retrieve a string containing the path of the directory in which
' custom profiles are stored.
sProfileDirectory = ProfileMgr.ProfileDirectory

Requirements

Reference: Windows Media Encoder

Library: wmenc.exe

See Also