Rd Party Application Requirements; Technical Requirements For Windows Application Viewer - Siemens MM8000 Integration Manual

rd
3 3 Party Application Requirements
3.1

Technical Requirements for Windows Application Viewer

16
Building Technologies
Fire Safety & Security Products
This chapter presents the technical requirements that a 3
tion must match to be integrated in MM8000 as a video (or more general data)
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
the following Windows control messages:
048_DMS_DMS8000_Generic_DVR_Integration_Guide_MP4.50_A6V10331273_a_en

3rd Party Application Requirements

rd
party software applica-
rd
party viewer that support
06.2012