IWMIndexer2::Configure method (wmsdkidl.h)

Artigo
4/26/2023

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The Configure method changes the internal settings of the indexer object. You can use Configure to activate frame-based indexing or SMPTE time code indexing. Configure does not create an index, it just configures the indexer object. After you have changed the desired settings, you must call IWMIndexer::StartIndexing to create the index.

Syntax

HRESULT Configure(
  [in] WORD             wStreamNum,
  [in] WMT_INDEXER_TYPE nIndexerType,
  [in] void             *pvInterval,
  [in] void             *pvIndexType
);

Parameters

[in] wStreamNum

WORD containing the stream number for which an index is to be made. If you pass 0, all streams will be indexed.

[in] nIndexerType

A variable containing one member of the WMT_INDEXER_TYPE enumeration type.

[in] pvInterval

This void pointer must point to a DWORD containing the desired indexing interval. Intervals for temporal indexing are in milliseconds. Frame-based index intervals are specified in frames.

If you pass NULL, Configure will use the default value. For temporal indexes, the default value is 3000 milliseconds, for frame-based indexes it is 10 frames.

[in] pvIndexType

This void pointer must point to a WORD value containing one member of the WMT_INDEX_TYPE enumeration type. If you pass NULL, Configure will use the default value.

The default value is WMT_IT_NEAREST_CLEAN_POINT. Using another index type degrades seeking performance.

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_OUTOFMEMORY	The method is unable to add the stream number to its internal list.

Remarks

You can call Configure as many times as needed to configure multiple streams in a file. You must make all desired calls to Configure before you start indexing. If you configure and index a file that already has an index, the existing index will be deleted.

If you configure the indexer to build a frame-based index, it will also create a temporal index. This is required for synchronizing audio and video.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only],Windows Media Format 9 Series SDK, or later versions of the SDK
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wmsdkidl.h (include Wmsdk.h)
Library	Wmvcore.lib; WMStubDRM.lib (if you use DRM)

Compartilhar via