Microsoft DirectX 8.1 (C++)

IDvdControl2::PlayChapterInTitle

The PlayChapterInTitle method starts playback from the beginning of the specified chapter of the specified title.

Syntax

HRESULT PlayChapterInTitle(
  ULONG ulTitle,
  ULONG ulChapter,
  DWORD dwFlags,
  IDvdCmd **ppCmd
);

Parameters

ulTitle

[in] Value that specifies the title in which the chapter is located; this value must be from 1 through 99.

ulChapter

[in] Value that specifies the chapter in the specified title where the DVD Navigator will start playback; this value must be from 1 through 999.

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 interface 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.
E_INVALIDARG Invalid argument.

Remarks

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

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

Annex J Command Name Valid Domains
PTT_Play DVD_DOMAIN_VideoManagerMenu
DVD_DOMAIN_VideoTitleSetMenu
DVD_DOMAIN_Title
DVD_DOMAIN_Stop

See Also