IMultiMediaStream::GetMediaStream (Windows Embedded CE 6.0)
1/6/2010
This method retrieves a media stream that has the specified purpose ID.
Syntax
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 Value
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |