Skip to content

Latest commit

 

History

History
68 lines (57 loc) · 3.95 KB

nn-control-iqueuecommand.md

File metadata and controls

68 lines (57 loc) · 3.95 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:control.IQueueCommand
IQueueCommand (control.h)
The IQueueCommand interface queues a command for processing at a designated time.
IQueueCommand
IQueueCommand interface [DirectShow]
IQueueCommand interface [DirectShow]
described
IQueueCommandInterface
control/IQueueCommand
dshow.iqueuecommand
dshow\iqueuecommand.htm
dshow
08efcbec-ce17-44e8-a3c1-4b5b95dcaaa4
4/26/2023
IQueueCommand, IQueueCommand interface [DirectShow], IQueueCommand interface [DirectShow],described, IQueueCommandInterface, control/IQueueCommand, dshow.iqueuecommand
control.h
Dshow.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Strmiids.lib
Windows
19H1
IQueueCommand
control/IQueueCommand
c++
APIRef
kbSyntax
COM
Strmiids.lib
Strmiids.dll
IQueueCommand

IQueueCommand interface

-description

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IQueueCommand interface queues a command for processing at a designated time. The Filter Graph Manager exposes this interface. Applications can use it to queue graph-control commands in advance.

The methods in IQueueCommand are modeled after the IDispatch::InvokeAt method. The application specifies an interface, a method on the interface, parameters to the method, and a reference time. The Filter Graph Manager queues this information and then invokes the method at the specified time. The requested interface must inherit IDispatch and must be exposed by the Filter Graph Manager. Examples include IMediaControl, IMediaEventEx, and IMediaPosition.

When the command is queued, the filter graph manager returns a pointer to the IDeferredCommand interface. The application can use this interface to cancel or modify the command.

Note  The two methods in IQueueCommand refer to stream time and presentation time, respectively. In the context of the Filter Graph Manager, stream time and presentation time are identical, so there is no functional difference between the two methods. Other objects could implement IQueueCommand differently. For more information about stream time and presentation time, see Time and Clocks in DirectShow.
 

-inheritance

The IQueueCommand interface inherits from the IUnknown interface. IQueueCommand also has these types of members: