IMediaStream::GetInformation

This method retrieves the stream's purpose ID and media type.

HRESULT GetInformation(
  MSPID* pPurposeId,
  STREAM_TYPE* pType
);

Parameters

  • pPurposeId
    [out] Pointer to an MSPID value that will contain the stream's purpose ID. If this parameter is NULL on entry, the method will not retrieve the purpose ID.
  • pType
    [out] Pointer to a STREAM_TYPE enumerated data type value that will contain the stream's media type. If this parameter is NULL on entry, the method will not retrieve the media type.

Return Values

Returns S_OK if successful or E_POINTER if one of the parameters is invalid.

Remarks

The value retrieved in the pPurposeId parameter will usually be either MSPID_PrimaryVideo, which identifies the primary video stream, or MSPID_PrimaryAudio, which identifies the primary audio stream; however, you can define other values if necessary.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

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

See Also

IMediaStream Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.