Main Page | Class List | File List | Class Members | File Members

IAAFComponent Interface Reference

Detailed Description

IAAFComponent is DEPRECATED, please use IAAFComponent2.

The component class represents an essence element. A Component is an abastract class with two subclasses: Segment and Transition. The GetLength and SetLength only aplies to time-varying media and it is an optional property. Non time-varying objects DO NOT support this property.

In addition to the specific error results listed for each method, all methods in this interface may also return one of the following values:

AAFRESULT_NOMEMORY

insufficient system memory is available to perform the operation.

AAFRESULT_NOT_INITIALIZED

This object has not yet had Initialize() called on it through this object's primary interface. Note that IAAFComponent is a primary interface for an abstract class, so it is not appropriate for the Initialize() method to exist in this interface. The Initialize() method is available through the concrete object's primary interface.

Objects that implement IAAFComponent also implement the following interfaces:

Definition at line 1311 of file AAF.idl.

Public Member Functions

HRESULT SetLength ([in] aafLength_constref length)

Sets the length property value on this component object.

HRESULT GetLength ([retval][out] aafLength_t *pLength)

Gets the duration in edit units of this component.

HRESULT SetDataDef ([in] IAAFDataDef *pDataDef)

sets the data definition property AUID on this component.

HRESULT GetDataDef ([out, retval] IAAFDataDef **ppDatadef)

returns data definition object.

HRESULT AppendKLVData ([in] IAAFKLVData *pData)

Appends a pre-existing KLV Data object to the specified component.

HRESULT CountKLVData ([out] aafUInt32 *pNumData)

return total number of KLV data objects attached to this component.

HRESULT GetKLVData ([out] IEnumAAFKLVData **ppEnum)

return the enumeration for all KLV data objects on this component.

HRESULT RemoveKLVData ([in] IAAFKLVData *pData)

/// Removes the given KLV data object from this component.

Member Function Documentation

HRESULT IAAFComponent::AppendKLVData ( [in] IAAFKLVData * pData )

Appends a pre-existing KLV Data object to the specified component.
Succeeds if all of the following are true:

the pKLV pointer is valid.

If this method fails no state will be changed.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

the pData arg is NULL.

Parameters:

pData [in] KLV object

HRESULT IAAFComponent::CountKLVData ( [out] aafUInt32 * pNumData )

return total number of KLV data objects attached to this component.
Succeeds if all of the following are true:

the pNumData pointer is valid.

If this method fails nothing will be written to *pNumComments.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

pNumData arg is NULL.

Parameters:

pNumData [out] Number of KLV data objects

HRESULT IAAFComponent::GetDataDef ( [out, retval] IAAFDataDef ** ppDatadef )

returns data definition object.
Succeeds if all of the following are true:

the ppDatadef pointer is valid.

If this method fails nothing will be written to *ppDatadef.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

ppDatadef arg is NULL.

Parameters:

ppDatadef [out, retval] DataDef of this object

HRESULT IAAFComponent::GetKLVData ( [out] IEnumAAFKLVData ** ppEnum )

return the enumeration for all KLV data objects on this component.
The returned enumerator is AddRef()ed before it is returned. The enumerator is implemented as a EnumAAFKLVData.
Succeeds if all of the following are true:

the ppEnum pointer is valid.

If this method fails nothing will be written to *ppEnum.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

ppEnum is null.

Parameters:

ppEnum [out] KLV data objects

HRESULT IAAFComponent::GetLength ( [out] aafLength_t * pLength )

Gets the duration in edit units of this component.
Succeeds if all of the following are true:

the pLength pointer is valid.
the optional length property is present for this object.

This method deals with an optional property, which will only be present for time-varying media.
If this method fails nothing will be written to *pLength.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

pLength arg is NULL.

AAFRESULT_BAD_PROP

the optional length property is not present for this object.

Parameters:

pLength [retval][out] Length of this component

HRESULT IAAFComponent::RemoveKLVData ( [in] IAAFKLVData * pData )

/// Removes the given KLV data object from this component.
Succeeds if all of the following are true:

the pData pointer is valid.
the given KLV data object is present in the component.

If this method fails no state will be changed.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

pData is null.

AAFRESULT_OBJECT_NOT_FOUND

the given KLV data object is not in this component.

Parameters:

pData [in] KLV data object to remove

HRESULT IAAFComponent::SetDataDef ( [in] IAAFDataDef * pDataDef )

sets the data definition property AUID on this component.
If this method fails the Data Definition property will not be changed.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_NULL_PARAM

pDataDef arg is NULL.

Parameters:

pDataDef [in] DataDef of this object

HRESULT IAAFComponent::SetLength ( [in] aafLength_constref length )

Sets the length property value on this component object.
Succeeds if all of the following are true:

the optional length property is present for this object.

This method deals with an optional property, which will only be present for time-varying media.
If this method fails the length property will not be changed.
This method will return the following codes. If more than one of the listed errors is in effect, it will return the first one encountered in the order given below:
AAFRESULT_SUCCESS

succeeded. (This is the only code indicating success.)

AAFRESULT_BAD_PROP

the optional length property is not present for this object.

Parameters:

length [in] The duration in edit units of this component

Generated on Thu Feb 17 09:34:14 2005 for AAF COM API by

1.4.1


Public Member Functions
HRESULT	SetLength ([in] aafLength_constref length)
	Sets the length property value on this component object.
HRESULT	GetLength ([retval][out] aafLength_t *pLength)
	Gets the duration in edit units of this component.
HRESULT	SetDataDef ([in] IAAFDataDef *pDataDef)
	sets the data definition property AUID on this component.
HRESULT	GetDataDef ([out, retval] IAAFDataDef **ppDatadef)
	returns data definition object.
HRESULT	AppendKLVData ([in] IAAFKLVData *pData)
	Appends a pre-existing KLV Data object to the specified component.
HRESULT	CountKLVData ([out] aafUInt32 *pNumData)
	return total number of KLV data objects attached to this component.
HRESULT	GetKLVData ([out] IEnumAAFKLVData **ppEnum)
	return the enumeration for all KLV data objects on this component.
HRESULT	RemoveKLVData ([in] IAAFKLVData *pData)
	/// Removes the given KLV data object from this component.