COutputQueue::IsSpecialSample

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

BOOL IsSpecialSample(
IMediaSample *pSample );

Parameters

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

Return Values

Returns one of the following values.

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.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.