Share via


COutputQueue::IsSpecialSample

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Determines if a sample is one of the special control samples (containing no data).

Syntax

BOOL IsSpecialSample(
  IMediaSample* pSample 
);

Parameters

  • pSample
    Pointer to the sample to be passed to the connected input pin.

Return Value

Returns one of the following values.

Value Description

TRUE

pSample is a special control sample.

FALSE

pSample is an IMediaSample interface.

Remarks

Special control samples are queued in line with the data by methods (such as COutputQueue::EOS) that require processing once all queued data has been delivered.

The COutputQueue::ThreadProc member function detects these special samples on the queue by using IsSpecialSample and processes them appropriately.

A special sample is one of following types and contains no media data:

  • EOS_PACKET
  • NEW_SEGMENT
  • RESET_PACKET
  • SEND_PACKET

Special control samples are relevant only if you plan to change or extend the default base class implementation of COutputQueue in a derived class. Normal use of the COutputQueue class does not require the use of control samples.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 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