Share via

ITransformPropertiesConfig::CreateProperty

  • Article

The CreateProperty method creates a new property and adds it to the current property collection.

Syntax

HRESULT CreateProperty(
  LPCTSTR  szPropertyName,
  PROPVARIANT  varValue,
  ITransformProperty**  ppNewProperty
);

Parameters

szPropertyName

[in]  A pointer to a NULL-terminated string that specifies the name for the new property.

varValue

[in]  A PROPVARIANT that specifies the value of the new property.

ppNewProperty

[out]  Address of a pointer to the newly created property.

Return Values

The method returns an HRESULT of S_OK for success, or a standard COM error code for failure.

Remarks

An alternate way of creating a new property is to call ITransformPropertiesConfig::SetPropertyValue; however, if the property with the specified name already exists, that method will overwrite the existing property.

Requirements

Client: Windows Vista

Header: Include gputransformplugin.h and GPUPipelineTime.h.

Library: Use GPUPipelineVC7.lib (for Visual Studio .NET) or GPUPipelineVC8.lib (for Visual Studio 2005).

See Also