IAAFAIFCDescriptor Interface Reference

List of all members.

---

Detailed Description

The IAAFAIFCDescriptor interface is implemented by objects which describe audio content data formatted according to the AIFC compressed Audio File Format.

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.

Objects that implement IAAFAIFCDescriptor also implement the following interfaces:

• IAAFFileDescriptor
• IAAFEssenceDescriptor
• IAAFObject

Definition at line 229 of file AAF.idl.

Public Member Functions
HRESULT	Initialize ()
	Initializes a newly allocated, empty IAAFAIFCDescriptor-supporting object.
HRESULT	GetSummary ([in] aafUInt32 size,[out, size_is(size)] aafDataValue_t pSummary)
	Gets a copy of the AIFC file information without the media.
HRESULT	GetSummaryBufferSize ([out] aafUInt32 *pSize)
	Returns the size of the buffer required for the GetSummary() method.
HRESULT	SetSummary ([in] aafUInt32 size,[in, size_is(size)] aafDataValue_t pSummary)
	Sets the AIFC file information.

---

Member Function Documentation

HRESULT IAAFAIFCDescriptor::GetSummary (  [in] aafUInt32  size, [out, size_is(size)] aafDataValue_t  pSummary )

Gets a copy of the AIFC file information without the media. Succeeds if all of the following are true: pSummary is a valid pointer. The size of the buffer is large enough to hold the AIFC file information. If this method fails pSummary will not be changed. This method will return the following codes: AAFRESULT_SUCCESS succeeded. AAFRESULT_NULL_PARAM pSummary arg is NULL. AAFRESULT_SMALLBUF The buffer is too small to hold the AIFC file information. Parameters: size  [in] Size of preallocated buffer pSummary  [out, size_is(size)] Preallocated buffer to hold the AIFC file information

HRESULT IAAFAIFCDescriptor::GetSummaryBufferSize (  [out] aafUInt32 *  pSize  )

Returns the size of the buffer required for the GetSummary() method. The value is placed into the location specified by pSize. Succeeds if all of the following are true: the pSize pointer is valid. If this method fails nothing will be written to *pSize. This method will return the following codes: AAFRESULT_SUCCESS succeeded. AAFRESULT_NULL_PARAM pSize arg is NULL. Parameters: pSize  [out] required buffer size

HRESULT IAAFAIFCDescriptor::Initialize (   )

Initializes a newly allocated, empty IAAFAIFCDescriptor-supporting object. This method must be called after allocation, and before any other method can be called. Succeeds if: Initialize() has not yet been called on this object. 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_ALREADY_INITIALIZED Initialize() has already been called on this object.

HRESULT IAAFAIFCDescriptor::SetSummary (  [in] aafUInt32  size, [in, size_is(size)] aafDataValue_t  pSummary )

Sets the AIFC file information. Succeeds if all of the following are true: pSummary is a valid pointer If this method fails the summary property will not be changed. This method will return the following codes: AAFRESULT_SUCCESS succeeded. AAFRESULT_NULL_PARAM pSummary arg is NULL. Parameters: size  [in] Size of preallocated buffer pSummary  [in, size_is(size)] buffer containing value

---