This interface is DEPRECATED, please use IAAFEssenceData2. More...

Public Member Functions
HRESULT	Initialize ([in] IAAFSourceMob *pFileMob)
	Associates a weak reference to the given file mob with the essence data.
HRESULT	Write ([in] aafUInt32 bytes,[out, size_is(bytes)] aafDataBuffer_t buffer,[out, ref] aafUInt32 *bytesWritten)
	Write pre-interleaved data to a essence stream.
HRESULT	Read ([in] aafUInt32 bytes,[out, size_is(bytes), length_is(bytesRead)] aafDataBuffer_t buffer,[out, ref] aafUInt32 bytesRead)
	Read pre-interleaved data from a essence stream.
HRESULT	SetPosition ([in] aafPosition_t offset)
	Seek to absolute position within the essence data.
HRESULT	GetPosition ([out] aafPosition_t *pOffset)
	Get the absolute position within the essence data.
HRESULT	GetSize ([out] aafLength_t *pSize)
	Return the total size of the essence data.
HRESULT	WriteSampleIndex ([in] aafUInt32 bytes,[out, size_is(bytes)] aafDataBuffer_t buffer,[out, ref] aafUInt32 *bytesWritten)
	Write pre-interleaved data to a sample index stream.
HRESULT	ReadSampleIndex ([in] aafUInt32 bytes,[out, size_is(bytes), length_is(bytesRead)] aafDataBuffer_t buffer,[out, ref] aafUInt32 bytesRead)
	Read pre-interleaved data from a sample index stream.
HRESULT	SetSampleIndexPosition ([in] aafPosition_t offset)
	Seek to absolute position within the sample index data.
HRESULT	GetSampleIndexPosition ([out] aafPosition_t *pOffset)
	Get the absolute position within the sample index data.
HRESULT	GetSampleIndexSize ([out] aafLength_t *pSize)
	Return the total size of the sample index data.
HRESULT	SetFileMob ([in] IAAFSourceMob *pFileMob)
	Associates a weak reference to the given file mob with the essence data.
HRESULT	GetFileMob ([in] IAAFSourceMob **ppFileMob)
	Associates a weak reference to the given file mob with the essence data.
HRESULT	GetFileMobID ([out] aafMobID_t *pFileMobID)
	Return the mob id used to find the file mob associated with this essence.

Detailed Description

This interface is DEPRECATED, please use IAAFEssenceData2.

The IAAFEssenceData interface is used to modify AAFEssenceData objects, which contain the actual essence data (ex. WAVE) when it is contained within an AAF file. Normally the client application would access the essence through the IAAFEssenceAccess interface, which handles the work of finding and (de)compressing the data. However, in rare cases direct access to the data is required, so this interface is exposed.

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_NULL_PARAM

One of the passed in pointers is NULL.

AAFRESULT_NOMEMORY

insufficient system memory is available to perform the operation.

Objects that implement IAAFEssenceDataEx also implement the following interfaces:

IAAFObject

Definition at line 44454 of file AAF.idl.

Member Function Documentation

HRESULT IAAFEssenceDataEx::GetFileMob ( [in] IAAFSourceMob ** ppFileMob )

Associates a weak reference to the given file mob with the essence data.

Succeeds if all of the following are true:

the ppFileMob pointer is valid and a weak reference to the associated file mob can be resolved.

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

ppFileMob is null.

Parameters:

ppFileMob [in] reference to a file mob

HRESULT IAAFEssenceDataEx::GetFileMobID ( [out] aafMobID_t * pFileMobID )

Return the mob id used to find the file mob associated with this essence.

The file mob must exist in the same file as this essence data.

Parameters:

pFileMobID [out] the file mob id associated with essence

HRESULT IAAFEssenceDataEx::GetPosition ( [out] aafPosition_t * pOffset )

Get the absolute position within the essence data.

Parameters:

pOffset [out] offset from beginning of essence

HRESULT IAAFEssenceDataEx::GetSampleIndexPosition ( [out] aafPosition_t * pOffset )

Get the absolute position within the sample index data.

Parameters:

pOffset [out] offset from beginning of sample index

HRESULT IAAFEssenceDataEx::GetSampleIndexSize ( [out] aafLength_t * pSize )

Return the total size of the sample index data.

Parameters:

pSize [out] size of sample index data

HRESULT IAAFEssenceDataEx::GetSize ( [out] aafLength_t * pSize )

Return the total size of the essence data.

Parameters:

pSize [out] size of essence data

HRESULT IAAFEssenceDataEx::Initialize ( [in] IAAFSourceMob * pFileMob )

Associates a weak reference to the given file mob with the essence data.

Succeeds if all of the following are true:

the pFileMob pointer is valid and points to a file mob (contains a file descriptor).

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

pFileMob is null.

Parameters:

pFileMob [in] reference to a file mob

HRESULT IAAFEssenceDataEx::Read	(	[in] aafUInt32	bytes,
		[out, size_is(bytes), length_is(*bytesRead)] aafDataBuffer_t	buffer,
		[out, ref] aafUInt32 *	bytesRead
	)

Read pre-interleaved data from a essence stream.

Parameters:

bytes	[in] read this many bytes from the data stream
buffer	[out, size_is(bytes), length_is(*bytesRead)] here is the buffer
bytesRead	[out,ref]

HRESULT IAAFEssenceDataEx::ReadSampleIndex	(	[in] aafUInt32	bytes,
		[out, size_is(bytes), length_is(*bytesRead)] aafDataBuffer_t	buffer,
		[out, ref] aafUInt32 *	bytesRead
	)

Read pre-interleaved data from a sample index stream.

Parameters:

bytes	[in] read this many bytes from the sample index stream
buffer	[out, size_is(bytes), length_is(*bytesRead)] here is the buffer
bytesRead	[out,ref]

HRESULT IAAFEssenceDataEx::SetFileMob ( [in] IAAFSourceMob * pFileMob )

Associates a weak reference to the given file mob with the essence data.

Succeeds if all of the following are true:

the pFileMob pointer is valid and points to a file mob (contains a file descriptor).

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

pFileMob is null.

Parameters:

pFileMob [in] reference to a file mob

HRESULT IAAFEssenceDataEx::SetPosition ( [in] aafPosition_t offset )

Seek to absolute position within the essence data.

Parameters:

offset [in] offset from beginning of essence

HRESULT IAAFEssenceDataEx::SetSampleIndexPosition ( [in] aafPosition_t offset )

Seek to absolute position within the sample index data.

Parameters:

offset [in] offset from beginning of sample index

HRESULT IAAFEssenceDataEx::Write	(	[in] aafUInt32	bytes,
		[out, size_is(bytes)] aafDataBuffer_t	buffer,
		[out, ref] aafUInt32 *	bytesWritten
	)

Write pre-interleaved data to a essence stream.

Parameters:

bytes	[in] write this many bytes to the data stream
buffer	[out, size_is(bytes)] here is the buffer
bytesWritten	[out,ref]

HRESULT IAAFEssenceDataEx::WriteSampleIndex	(	[in] aafUInt32	bytes,
		[out, size_is(bytes)] aafDataBuffer_t	buffer,
		[out, ref] aafUInt32 *	bytesWritten
	)

Write pre-interleaved data to a sample index stream.

Parameters:

bytes	[in] write this many bytes to the sample index stream
buffer	[out, size_is(bytes)] here is the buffer
bytesWritten	[out,ref]

Public Member Functions

Detailed Description

Member Function Documentation