GxSmuPanel

Applies To

GX3104, GX3116e

Purpose

Opens a virtual panel used to interactively control the GX3104 or GX3116e.

Syntax

GxSmuPanel (pnHandle, hwndParent, nMode, phwndPanel, pnStatus)

Parameters

Name
Type
Description
nHandle
PSHORT
Handle to a GX3104 or GX3116e board.
hwndParent
HWND
Panel parent window handle. A value of 0 sets the desktop as the parent window.
nMode
SHORT
The mode in which the panel main window is created. 0 for modeless window and 1 for modal window.
phwndPanel
PHWND
Returned window handle for the panel.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function is used to create the panel window. The panel window may be opened as a modal or a modeless window depending on the nMode parameters.

If the mode is set to modal dialog (nMode=1), the panel will disable the parent window (hwndParent) and the function will return only after the window was closed by the user. In that case, the pnHandle may return the handle created by the user using the panel Initialize dialog. This handle may be used when calling other SMU functions.

If a modeless dialog was created (nMode=0), the function returns immediately after creating the panel window returning the window handle to the panel - phwndPanel. It is the responsibility of the calling program to dispatch windows messages to this window so that the window can respond to messages.

Example

The following example opens the panel in modal mode:

 

DWORD dwPanel;

SHORT nHandle=0, nStatus;

GxSmuPanel(&nHandle, 0, 1, &dwPanel, &nStatus);

 

See Also

GxSmuInitialize, GxSmuGetErrorString