IDVDHighlightInfo::GetHLIStatus

  • Article

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

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.