Partager via


IMultiMediaStream::GetMediaStream (Windows CE 5.0)

Send Feedback

This method retrieves a media stream that has the specified purpose ID.

HRESULT GetMediaStream(REFMSPID idPurpose,IMediaStream** ppMediaStream);

Parameters

  • idPurpose
    [in] Value that specifies the desired stream.
  • ppMediaStream
    [out] Address of a pointer to an IMediaStream interface that will point to the desired media stream.

Return Values

Returns one of the following values.

Value Description
E_POINTER The ppMediaStream pointer is invalid.
MS_E_NOSTREAM No stream has the specified purpose ID.
S_OK Success.

Remarks

If a stream exists that matches the purpose ID in idPurpose, the ppMediaStream parameter points to the stream and increments its reference count.

MSPID_PrimaryVideo and MSPID_PrimaryAudio, which represent the primary video and audio streams, are the most commonly used purpose IDs.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IMultiMediaStream Interface

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.