Microsoft DirectX 8.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 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 methodsDescription
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IDvdCmd methodsDescription
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.

IDvdCmd::WaitForEnd

IDvdCmd Interface

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.

IDvdCmd::WaitForStart

IDvdCmd Interface

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.