CCmdQueue::GetCommandDueFor
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