

                       Wimp message DigitalCD_Misc


  The protocol below was defined to allow utilities like MMK_DCD to send
  for example keyboard shortcuts to one of the DigitalCD control panel.

  Defining a few terms: Controller 0 is the music files window, 1 is the CD
  window for drive 0, 2 is CD 1 etc etc. The Primary Controller is the one
  configured to open with Select, the Secondary Controller opens with Adjust.

  Wimp message &5327E "DigitalCD_Misc"

    +16  &5327E
    +20  Reason code
          0  Controller info                          send BY DigitalCD
          1  Ask controller info                    }
          2  Ask primary controller info   (Select) } send TO DigitalCD
          3  Ask secondary controller info (Adjust) }
    + 24 ...

  Reason code 0 is sent by DigitalCD to provide information on controllers.
  It is either broadcasted to every application with information regarding
  the primary controller (at startup or when the primary controller changes)
  or it is send as a reply to a message with reason code 1,2 or 3.

    +16  &5327E
    +20  0
    +24  Controller number
           0   Music files
          1..n CDFS::(n-1)
    +28  DCDUtils handle under which the player is registered
    +32  the current window handle of the controller

    The window handle of the controller is only valid when the message is
    received but is subject to change in time (minibar, skin changes, ...). To
    have up to date information you should call the SWI DCDUtils_GetPlayerInfo
    with the DCDUtils handle returned here (which remains valid until DigitalCD
    is terminated).

    In case you wonder MMK_DCD just translates the MMK keypresses into shortcuts
    used by DigitalCD and sends "Wimp_KeyPress" events to DigitalCD using the
    window handle returned by DCDUtils_GetPlayerInfo.

  Reason codes 1,2 and 3 are send by other applications to request information.

    +16  &5327E
    +20  1
    +24  Controller number

    +16  &5327E
    +20  2 or 3
