Share via

CCmdQueue::GetCommandDueFor

  • Article
 
Microsoft DirectShow 9.0

CCmdQueue::GetCommandDueFor

The GetCommandDueFor method retrieves a deferred command that is scheduled at a specified time.

Syntax

  virtual HRESULT GetCommandDueFor(
    REFERENCE_TIME tStream,
    CDeferredCommand **ppCmd
);

Parameters

tStream

Time for which the command is scheduled.

ppCmd

Address of a pointer to the deferred command to be carried out at the time specified in the tStream parameter.

Return Value

Returns VFW_E_NOT_FOUND if no commands are due; otherwise, returns S_OK.

Remarks

This member function takes a stream time and returns the deferred command scheduled at that time. The actual stream-time offset is calculated when the command queue is run. Commands remain queued until run or canceled. This member function will not block.

Requirements

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

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

See Also