ShellProc (Windows Embedded CE 6.0)

1/6/2010

This function allows for communication between Tux and the test module. Messages are passed to the ShellProc function to notify or query the test module. All Tux.dll test modules must implement and export a ShellProc function.

Syntax

SHELLPROCAPI ShellProc(
  UINT uMsg,
  SPPARAM spParam
)

Parameters

• uMsg
  Message value being passed to ShellProc. This parameter may be one of the following values:

  • SPM_LOAD_DLL
  • SPM_UNLOAD_DLL
  • SPM_SHELL_INFO
  • SPM_REGISTER
  • SPM_START_SCRIPT
  • SPM_STOP_SCRIPT
  • SPM_BEGIN_GROUP
  • SPM_END_GROUP
  • SPM_BEGIN_TEST
  • SPM_END_TEST
  • SPM_EXCEPTION

• spParam
  Dependent on the uMsg parameter; usually a pointer to a structure for that message type.

Return Values

Returns SPR_NOT_HANDLED for all messages that are not handled.

Remarks

Every Tux module must at least handle the SPR_REGISTER message; all other messages are optional. See Tuxdemo.cpp for a sample ShellProc implementation.

Requirements

Header	tux.h
Library	coredll.lib
Windows Embedded CE	Windows CE 3.0 and later

See Also

Reference

Tux Functions