Microsoft DirectX 9.0

IDvdCmd Interface

The IDvdCmd interface is implemented on command synchronization objects allocated by the DVD Navigator. If instructed by an application in an IDvdControl2 "play" method call such as IDvdControl2::PlayTitle, IDvdControl2::PlayAtTimeInTitle, and so on, the DVD Navigator will allocate a command synchronization object and pass a pointer to its IDvdCmd back to the application. The command synchronization object stores the results of the command at both the start (when the command has begun processing) and the end after it has completed. The application can use the object to block the DVD Navigator until the command starts or completes.

For complete information on using command synchronization objects and the IDvdCmd interface, see Synchronizing DVD Commands. (This article also discusses alternate ways to synchronize commands without using command synchronization objects.)

Note   Although the DVD Navigator allocates the command synchronization object, the application must call Release on the object when it is done with it.

In addition to the methods inherited from IUnknown, the IDvdCmd interface exposes the following methods.

Method Description
WaitForStart Blocks the DVD Navigator until the command associated with this object begins.
WaitForEnd Blocks the DVD Navigator until the command associated with this object completes or is canceled.