IWMPropertyVault::SetProperty method (wmsdkidl.h)

Artikel
4/26/2023

[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 SetProperty method sets the values for a property. If the property named already exists in the property vault, SetProperty changes its value as specified. If the property named does not exist, SetProperty adds it to the property vault.

Syntax

HRESULT SetProperty(
  [in] LPCWSTR           pszName,
  [in] WMT_ATTR_DATATYPE pType,
  [in] BYTE              *pValue,
  [in] DWORD             dwSize
);

Parameters

[in] pszName

Pointer to a null-terminated string containing the name of the property to set.

The following table lists the property names supported by the IWMPropertyVault interface. The property used dictates the data type and meaning of the data pointed to by pValue; these values are also in the table. All of these values apply to stream configuration objects.

Global constant	Data type	Description
g_wszOriginalSourceFormatTag	WMT_TYPE_WORD	When transcoding with smart recompression, set to the WAVEFORMATEX.wFormatTag used in the original encoding.This value is now obsolete, use g_wszOriginalWaveFormat instead.
g_wszOriginalWaveFormat	WMT_TYPE_BINARY	When transcoding with smart recompression, set to the WAVEFORMATEX structure used in the original encoding.
g_wszEDL	WMT_TYPE_STRING	For Windows Media Audio 9 Voice streams, use to manually specify sections of the stream that contain music. This property should only be used if the automatic selection by the codec is creating a poor quality stream.
g_wszComplexity	WMT_TYPE_WORD	Set to the complexity setting desired. You can find the complexity levels supported by a codec by calling IWMCodecInfo3::GetCodecProp.
g_wszDecoderComplexityRequested	WMT_TYPE_STRING	Set to the string value of the device conformance template that you would like the stream to be encoded to. For audio there is only one string value, for video, us the two-letter designation before the ampersand. For more information, see Device Conformance Template Parameters.
g_wszPeakValue	WMT_TYPE_DWORD	Set to the peak volume level by the audio codec. Used for normalization. Do not manually set.
g_wszAverageLevel	WMT_TYPE_DWORD	Set to the average volume level by the audio codec. Used for normalization. Do not manually set.
g_wszFold6To2Channels3	WMT_TYPE_STRING	Set to the value for 6 to 2 channel fold down. Use for multichannel audio.
g_wszFoldToChannelsTemplate	WMT_TYPE_STRING	Template string to create other fold down values.
g_wszMusicSpeechClassMode	WMT_TYPE_STRING	Set to the type of encoding you want to use with the Windows Media Audio 9 Voice codec. Can be set to:g_wszMusicClassMode g_wszSpeechClassMode g_wszMixedClassMode

In addition to the values in the table, the settings for variable bit rate encoding are set using this method. For more information, see Configuring VBR Streams.

[in] pType

Pointer to a member of the WMT_ATTR_DATATYPE enumeration type. This parameter specifies the type of data pointed to by pValue.

[in] pValue

Pointer to a data buffer containing the value of the property. This value can be one of several types. The type of data that the buffer contains on output is specified by the value of pType.

[in] dwSize

DWORD containing the size, in bytes, of the data at pValue.

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_INVALIDARG	pszName is NULL or points to a zero length string. OR The type specified at pValue does not agree with the size in bytes specified by dwSize. OR You are trying to delete a property that does not exist in the property vault.
E_OUTOFMEMORY	The method cannot allocate memory for a new property. OR The method cannot allocate memory for a new value.

Return code

Description

S_OK

The method succeeded.

E_INVALIDARG

pszName is NULL or points to a zero length string.

The type specified at pValue does not agree with the size in bytes specified by dwSize.

You are trying to delete a property that does not exist in the property vault.

E_OUTOFMEMORY

The method cannot allocate memory for a new property.

The method cannot allocate memory for a new value.

Remarks

Properties set on stream configuration objects using this method are persisted in the profile to which the stream configuration is added. However, files created using that profile do not contain these properties in the header information.

SetProperty does not return the index of the property affected. New properties are assigned indexes sequentially.

You can remove a property using SetProperty by passing either NULL as pValue or 0 as dwSize.

Requirements


Minimum supported client	Windows 2000 Professional [desktop apps only],Windows Media Format 9 Series 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)