COutputQueue::QueueSample

 
Microsoft DirectShow 9.0

COutputQueue::QueueSample

The QueueSample method queues a sample.

Syntax

  void QueueSample(
    IMediaSample *pSample
);

Parameters

pSample

Pointer to the sample's IMediaSample interface.

Remarks

This method adds a sample to the tail of the queue. Hold the critical section before calling this method, and call it only when the object is using a thread to deliver samples. To determine if the object is using a thread, call the COutputQueue::IsQueued method.

This method can also be used to put control messages onto the queue. A control message is a defined constant (cast to a LONG_PTR type) that instructs the thread to perform some action. The COutputQueue class defines the control messages shown in the following table.

Message Action
EOS_PACKET Deliver an end-of-stream notification.
NEW_SEGMENT Deliver a new segment.
RESET_PACKET Reset the state of the queue.
SEND_PACKET Send a partial batch of samples.

This is a protected method, which the COutputQueue class uses internally.

Requirements

**  Header:** Declared in Outputq.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also