IMFASFIndexer::GenerateIndexEntries method (wmcontainer.h)

Accepts an ASF packet for the file and creates index entries for them.

Syntax

HRESULT GenerateIndexEntries(
  [in] IMFSample *pIASFPacketSample
);

Parameters

[in] pIASFPacketSample

Pointer to the IMFSample interface of a media sample that contains the ASF packet.

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
The argument passed in is NULL.
MF_E_NOT_INITIALIZED
The indexer is not initialized.

Remarks

The ASF indexer creates indexes for a file internally. You can get the completed index for all data packets sent to the indexer by committing the index with IMFASFIndexer::CommitIndex and then calling IMFASFIndexer::GetCompletedIndex to write the index entries into a media buffer. To determine the size of the index so you can allocate a buffer large enough to hold the index, call IMFASFIndexer::GetIndexWriteSpace.

When this method creates index entries, they are immediately available for use by IMFASFIndexer::GetSeekPositionForValue.

The media sample specified in pIASFPacketSample must hold a buffer that contains a single ASF packet. Get the sample from the ASF multiplexer by calling the IMFASFMultiplexer::GetNextPacket method.

You cannot use this method while reading an index, only when writing an index.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wmcontainer.h
Library Mfuuid.lib

See also

ASF Index Object

IMFASFIndexer