IMFSourceReader::GetServiceForStream method (mfreadwrite.h)

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.

[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

See also

IMFSourceReader

Service Interfaces

Source Reader