IMFSourceReader::GetServiceForStream method (mfreadwrite.h)

Article
02/22/2024

Queries the underlying media source or decoder for an interface.

Syntax

HRESULT GetServiceForStream(
  [in]  DWORD   dwStreamIndex,
  [in]  REFGUID guidService,
  [in]  REFIID  riid,
  [out] LPVOID  *ppvObject
);

Parameters

[in] dwStreamIndex

The stream or object to query. If the value is MF_SOURCE_READER_MEDIASOURCE, the method queries the media source. Otherwise, it queries the decoder that is associated with the specified stream. The following values are possible.

Value	Meaning
0–0xFFFFFFFB	The zero-based index of a stream.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	The first video stream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	The first audio stream.
MF_SOURCE_READER_MEDIASOURCE 0xFFFFFFFF	The media source.

[in] guidService

A service identifier GUID. If the value is GUID_NULL, the method calls QueryInterface to get the requested interface. Otherwise, the method calls the IMFGetService::GetService method. For a list of service identifiers, see Service Interfaces.

[in] riid

The interface identifier (IID) of the interface being requested.

[out] ppvObject

Receives a pointer to the requested interface. The caller must release the interface.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This interface is available on Windows Vista if Platform Update Supplement for Windows Vista is installed.

Requirements

Requirement	Value
Minimum supported client	Windows 7, Windows Vista and Platform Update Supplement for Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 R2 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfreadwrite.h