COutputQueue::IsSpecialSample

  • Article

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.

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

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.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.