IMFASFMutualExclusion::AddRecord method (wmcontainer.h)

Article
02/22/2024

Adds a record to the mutual exclusion object. A record specifies streams that are mutually exclusive with the streams in all other records.

Syntax

HRESULT AddRecord(
  [out] DWORD *pdwRecordNumber
);

Parameters

[out] pdwRecordNumber

Receives the index assigned to the new record. Record indexes are zero-based and sequential.

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.

Remarks

A record can include one or more stream numbers. All of the streams in a record are mutually exclusive with all the streams in all other records in the ASF mutual exclusion object.

You can use records to create complex mutual exclusion scenarios by using multiple ASF mutual exclusion objects.

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