Siemens MM8000, Integration Manual

Page: 18 / 24

3rd Party Application Requirements
16
Building Technologies
048_DMS_DMS8000_Generic_DVR_Integration_Guide_MP4.50_A6V10331273_a_en
Fire Safety & Security Products 06.2012
3 3
rd
Party Application Requirements
This chapter presents the technical requirements that a 3
rd
party software applica-
tion must match to be integrated in MM8000 as a video (or more general data)
viewer.
3.1 Technical Requirements for Windows Application Viewer
Referring to the types of supported viewers described in 0 at p.6, these require-
ments concern the Windows application. This application must:

Supplied as a valid executable Windows application ( EXE file ) that is invoked
by MM8000 to start the viewer.

Support command-line parameters . Applying this technique, MM8000 pro-
vides the viewer with the parameters defined in the XML definition files (see 2.4
at p. 7).

Handle one main window according to Windows application design standards.
That window will be used by MM8000 to control the viewer application.

Avoid displaying any splash screen upon starting up. Such splash screens
would be quite annoying to users.

Support the start, stop and window control methods described below.
Windows start methods
MM8000 must be able to identify the viewer main window in the list provided by the
EnumThreadWindows function. The viewer must support at least one of the follow-
ing ways techniques (listed according to their priority):

Defining a custom variable named “APP_WINCTRL_CLASS” and assign the
class name of the main window as default value.

Defining a custom variable named “APP_WINCTRL_TITLE” and assign the title
of the main window as default value. Note that the caption text must be fixed.

Ensure that the main window has the following style settings:
– WS_CAPTION or WS_OVERLAPPED
– WS_EX_WINDOWEDGE
MM8000 expects the process to activate within 3 seconds and the main window to
start within 5 seconds from program invocation. Error logs are generated in case
any timeout expires (refer to 3.2.2 at p.17).
Windows close methods
MM8000 must be able to close the viewer application. The viewer must support at
least one of the following techniques:

Closing upon receiving the standard WM_CLOSE message.

Closing upon receiving the WM_ApplicationName_CLOSE message.
With
ApplicationName being the executable filename without the EXE exten-
sion.
After a 3 second wait, if the viewer application does not terminate, MM8000 stops
the application (process) using the
TerminateProcess windows function. An error
log is generated in case the timeout expires (refer to 3.2.2 at p.17).
Windows control methods
MM8000 must be able to resize, move and close the 3
rd
party viewer that support
the following Windows control messages: