Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method causes the decoder to display a highlight of the specified DVD button.
HRESULT Highlight(BYTE buttonNumber,EHighlightActionaction,BOOLbRelativeMode);
Parameters
buttonNumber
[in] Valid button number in the range 1**to 36 if bRelativeMode is FALSE and in the range 1 to 4 if bRelativeMode is TRUE (1=up, 2=down, 3=left, 4=right).action
[in] Describes the action state of the current highlight.The following table lists the values for the action parameter.
Value Description HIGHLIGHT_SELECT Selects the specified button. It displays the activation highlight if the button is turned on automatically. UNHIGHLIGHT Turns off highlight. ACTIVATE_BUTTON Displays the activation highlight. ACTIVATE_SELECTED Displays the activation highlight for the currently selected button. SELECT_AUTO_ACTIVATED Displays only the selection highlight even if the button is turned on automatically. bRelativeMode
[in] Qualifies the range of values that can be passed into buttonNumber. If set to FALSE, the valid button number is in the range of 1 to 36. If set to TRUE, the valid button number is in the range of 1 to 4 (1=up, 2=down, 3=left, 4=right).
Return Values
The following table shows a list of possible return values.
| Return value | Description |
|---|---|
| S_OK | The request completed successfully. |
| E_INVALIDARG | The button number is invalid. |
| E_UNEXPECTED | The highlight information is invalid. |
Remarks
The decoder executes this command only if there is an active subpicture, complete with active associated highlight information. Only one highlight can be selected.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Dvddrvr.idl.
See Also
EHighlightAction | IDVDRenderer:IUnknown
Send Feedback on this topic to the authors