IltmmDVDControl::GetButtonAtPosition

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl__getButtonAtPosition(pDVD, X, Y, pIndex)

C++ Syntax

HRESULT GetButtonAtPosition(X, Y, pIndex)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

long X;

/* x coordinate */

long Y;

/* y coordinate */

long *pIndex;

/* pointer to a variable */

Retrieves the number of the button located at the specified coordinates within the display window.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

X

The x-coordinate of the mouse pointer position.

Y

The y-coordinate of the mouse pointer position.

pIndex

Pointer to a variable that is updated with the number of the button at the specified position. Possible values range from 1 to 36.

Returns

S_OK

The function ran successfully.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Note that the upper limit value of 36 for the pIndex parameter is the absolute maximum. Call IltmmDVDControl::get_ButtonsAvailable to get the actual upper limit value , For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetButtonAtPosition at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/directshow/htm/idvdinfo2getbuttonatposition.asp.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Elements:

IltmmDVDControl interface, IltmmDVDControl::GetButtonTop, IltmmDVDControl::GetButtonLeft, IltmmDVDControl::GetButtonWidth, IltmmDVDControl::GetButtonHeight, IltmmDVDControl::get_CurrentButton, IltmmDVDControl::get_ButtonsAvailable, IltmmDVDControl::ActivateAtPosition, IltmmDVDControl::ActivateButton, IltmmDVDControl::SelectAtPosition, IltmmDVDControl::SelectAndActivateButton, IltmmDVDControl::SelectButton, IltmmDVDControl::SelectRelativeButton

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.

For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.