Share via


IDVDHighlightInfo::GetHLIStatus (Windows CE 5.0)

Send Feedback

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

HRESULT GetHLIStatus(UINT16* pStatus);

Parameters

  • pStatus
    [out] Address of HLI_SS.

Return Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Dvdata.h, Dvdata.idl.
Link Library: Ddvdids.lib.

See Also

IDVDHighlightInfo

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.