Share via

COutputQueue::IsSpecialSample (Compact 2013)

  • Article

3/26/2014

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

COutputQueue Class