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