IMultiMediaStream::GetMediaStream (Windows CE 5.0)
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
Send Feedback on this topic to the authors