Microsoft DirectX 9.0

IDvdControl2::PlayForwards

The PlayForwards method plays forward at the specified speed from the current location.

Syntax

HRESULT PlayForwards(
  double dwSpeed,
  DWORD dwFlags,
  IDvdCmd **ppCmd
);

Parameters

dwSpeed

[in] Value that specifies the playback speed. This value is a multiplier, where 1.0 is the authored speed, so a value of 2.5 plays at two and one-half times the authored speed, while a value of 0.5 plays at half the authored speed. The actual speed of playback depends on the capabilities of the video decoder.

dwFlags

[in] Bit flag that contains one or more DVD_CMD_FLAGS enumeration specifying command synchronization options.

ppCmd

[out] Address of a pointer to an IDvdCmd object that can be used to synchronize DVD commands.

Return Values

Returns one of the following values.

Return code Description
S_OK Success.
VFW_E_DVD_OPERATION_INHIBITED UOP control prohibits the operation.

Remarks

This method is demonstrated in the DVDSample application in CDvdCore::FastForward.

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name Valid Domains
Forward_Scan DVD_DOMAIN_VideoManagerMenu
DVD_DOMAIN_VideoTitleSetMenu
DVD_DOMAIN_Title

See Also