IMFASFMutualExclusion::GetStreamsForRecord method (wmcontainer.h)

Retrieves the stream numbers contained in a record in the Advanced Systems Format mutual exclusion object.

Syntax

HRESULT GetStreamsForRecord(
  [in]      DWORD dwRecordNumber,
  [out]     WORD  *pwStreamNumArray,
  [in, out] DWORD *pcStreams
);

Parameters

[in] dwRecordNumber

The number of the record for which to retrieve the stream numbers.

[out] pwStreamNumArray

An array that receives the stream numbers. Set to NULL to get the number of elements required, which is indicated by the value of pcStreams on return. If this parameter is not NULL, the method will copy as many stream numbers to the array as there are elements indicated by the value of pcStreams.

[in, out] pcStreams

On input, the number of elements in the array referenced by pwStreamNumArray. On output, the method sets this value to the count of stream numbers in the record. You can call GetStreamsForRecord with pwStreamNumArray set to NULL to retrieve the number of elements required to hold all of the stream numbers.

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.

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

IMFASFMutualExclusion

Using Mutual Exclusion for ASF Streams