COutputQueue::IsSpecialSample
A version of this page is also available for
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 |