Microsoft DirectX 8.0 |
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 PlayTitle, PlayAtTimeInTitle, and so on, the DVD Navigator will allocate a command synchronization object and pass a pointer to its IDvdCmd interface 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.
Methods in Vtable Order
IUnknown methods Description QueryInterface Retrieves pointers to supported interfaces. AddRef Increments the reference count. Release Decrements the reference count. IDvdCmd methods 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.
Blocks the DVD Navigator until the command associated with this object completes or is canceled.
Syntax
HRESULT WaitForEnd(void);
Return Value
Returns S_OK if successful or an HRESULT error code otherwise.
Blocks the DVD Navigator until the command associated with this object begins.
Syntax
HRESULT WaitForStart(void);
Return Value
Returns S_OK if successful or an HRESULT error code otherwise.