Share via


IDVDHighlightInfo::GetHLIStatus (Windows Embedded CE 6.0)

1/6/2010

This method returns the highlight information status (HLI_SS) from the highlight general information (HL_GI).

Syntax

HRESULT GetHLIStatus(
  UINT16* pStatus
);

Parameters

  • pStatus
    [out] Address of HLI_SS.

Return Value

This method always succeeds.

The return value is S_OK.

Remarks

Sometimes DVD-Video data is authored so that program chains without highlight information are presented in menu domains.

To guard against trying to read highlight information where none exists, it is a good practice to call IDVDHighlightInfo::GetHLIStatus prior to calling any of the other IDVDHighlightInfo methods.

This allows you to first check whether the highlight information exists prior to calling a method that relies on the presence of valid highlight information.

Requirements

Header dvdata.h, dvdata.idl
Library Ddvdids.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IDVDHighlightInfo