Microsoft DirectX 8.1 (C++)

IDvdControl2::PlayChapter

The PlayChapter method starts playback from the specified chapter in the current title.

Syntax

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

Parameters

ulChapter

[in] Value that specifies the chapter in the current 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 DVD Navigator begins playback at the specified chapter and continues to the subsequent chapters. Use IDvdControl2::PlayChaptersAutoStop to play the current chapter only.

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::PlayChapter.

Annex J Command Name Valid Domains
PTT_Search DVD_DOMAIN_Title

See Also