home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD1.iso / MPEG / WFSMP11 / SDK / README.1ST
Encoding:
Text File  |  1995-04-06  |  11.0 KB  |  496 lines
  1.  
  2.                 Windows Dynamic Linkage Library
  3.  
  4.         For software development you will need:
  5.  
  6.             (1) Microsoft C/C++ Version 7.0
  7.             (2) Microsoft Windows 3.1 Software Development Kit(SDK)
  8.  
  9.         Initialization/Exit Functions:
  10.  
  11.             MOVIE_Initialize
  12.             MOVIE_Exit
  13.  
  14.         Open/Close File Functions:
  15.  
  16.             MOVIE_OpenFile
  17.             MOVIE_CloseFile
  18.  
  19.         Playback Functions:
  20.  
  21.             MOVIE_Play
  22.             MOVIE_Stop
  23.             MOVIE_Pause
  24.  
  25.         Audio Control Functions:
  26.  
  27.             MOVIE_Mute
  28.             MOVIE_SetChannels
  29.  
  30.         Video Control Functions:
  31.  
  32.             MOVIE_SetVideoFrequency
  33.             MOVIE_SetDisplayPosition
  34.  
  35.         Nitofy Function:
  36.  
  37.             MOVIE_MovieNotify
  38.             MOVIE_PTSNotify
  39.             MOVIE_EOFNotify
  40.  
  41.         CD-ROM Functions:
  42.  
  43.             MOVIE_CDROM_Installed
  44.             MOVIE_CDROM_HasDisc
  45.             MOVIE_CDROM_IsDiscChanged
  46.             MOVIE_CDROM_GetTrackNo
  47.             MOVIE_CDROM_SeekTrack
  48.             MOVIE_CDROM_SeekCDI
  49.             MOVIE_CDROM_GetCDITitle
  50.  
  51.         -------------------------------------------------------------------
  52.  
  53.         Prototype:
  54.  
  55.             int FAR PASCAL MOVIE_Initialize(void);
  56.  
  57.         Description:
  58.  
  59.             Initialize the MPEG-1 playback hardware.
  60.  
  61.         Parameters:
  62.  
  63.             None.
  64.  
  65.         Return Value:
  66.  
  67.             0  : The MPEG-1 playback hardware is not found
  68.             -1 : Fail to allocate buffer for DMA
  69.             -2 : Cannot allocate memory below 1MB
  70.             -3 : Windows is not in 386 enhanced mode
  71.             1  : Successed
  72.  
  73.         -------------------------------------------------------------------
  74.  
  75.         Prototype:
  76.  
  77.             void FAR PASCAL MOVIE_Exit(int bSave);
  78.  
  79.         Description:
  80.  
  81.             Disable the MPEG-1 playback hardware.
  82.  
  83.         Parameters:
  84.  
  85.             int bSave: 0 - Do not save current configuration.
  86.                        1 - Save current configuration.
  87.  
  88.         Return Value:
  89.  
  90.             None.
  91.  
  92.         -------------------------------------------------------------------
  93.  
  94.         Prototype:
  95.  
  96.             int  FAR PASCAL MOVIE_OpenFile(char FAR *filename);
  97.  
  98.         Description:
  99.  
  100.             Open the specified MPEG file.
  101.  
  102.         Parameters:
  103.  
  104.             char FAR *filename: The MPEG file name.
  105.  
  106.         Return Value:
  107.  
  108.             0 : Failed
  109.             1 : Successed
  110.  
  111.         -------------------------------------------------------------------
  112.  
  113.         Prototype:
  114.  
  115.             int  FAR PASCAL MOVIE_CloseFile(void);
  116.  
  117.         Description:
  118.  
  119.             Close the previous opened MPEG file.
  120.  
  121.         Parameters:
  122.  
  123.             None.
  124.  
  125.         Return Value:
  126.  
  127.             0 : Failed
  128.             1 : Successed
  129.  
  130.         -------------------------------------------------------------------
  131.  
  132.         Prototype:
  133.  
  134.             int  FAR PASCAL MOVIE_Play(void);
  135.  
  136.         Description:
  137.  
  138.             Normal motion play.
  139.  
  140.         Parameters:
  141.  
  142.             None.
  143.  
  144.         Return Value:
  145.  
  146.             0 : Failed
  147.             1 : Successed
  148.  
  149.         -------------------------------------------------------------------
  150.  
  151.         Prototype:
  152.  
  153.             int  FAR PASCAL MOVIE_Stop(void);
  154.  
  155.         Description:
  156.  
  157.             Stop playing.
  158.  
  159.         Parameters:
  160.  
  161.             None.
  162.  
  163.         Return Value:
  164.  
  165.             0 : Failed
  166.             1 : Successed
  167.  
  168.         -------------------------------------------------------------------
  169.  
  170.         Prototype:
  171.  
  172.             int  FAR PASCAL MOVIE_Pause(void);
  173.  
  174.         Description:
  175.  
  176.             Pause playing.
  177.  
  178.         Parameters:
  179.  
  180.             None.
  181.  
  182.         Return Value:
  183.  
  184.             0 : Failed
  185.             1 : Successed
  186.  
  187.         -------------------------------------------------------------------
  188.  
  189.         Prototype:
  190.  
  191.             int  FAR PASCAL MOVIE_Mute(int flag);
  192.  
  193.         Description:
  194.  
  195.             Mute audio output.
  196.  
  197.         Parameters:
  198.  
  199.             int flag: 0 - Do not mute audio output
  200.                       1 - Mute audio output
  201.  
  202.         Return Value:
  203.  
  204.             0 : Failed
  205.             1 : Successed
  206.  
  207.         -------------------------------------------------------------------
  208.  
  209.         Prototype:
  210.  
  211.             void FAR PASCAL MOVIE_SetChannels(int LeftVolume,int RightVolume);
  212.  
  213.         Description:
  214.  
  215.             Set the volume of the audio channels.
  216.  
  217.         Parameters:
  218.  
  219.             int LeftVolume  - Volume of the left channel (0~63)
  220.             int RightVolume - Volume of the right channel (0~63)
  221.  
  222.             Note: The maximum volume is 0,the minimum volume is 63.
  223.  
  224.         Return Value:
  225.  
  226.             None.
  227.  
  228.         -------------------------------------------------------------------
  229.  
  230.         Prototype:
  231.  
  232.             void FAR PASCAL MOVIE_SetVideoFrequency(int VideoFrequency);
  233.  
  234.         Description:
  235.  
  236.             Set the output video frequency.
  237.  
  238.         Parameters:
  239.  
  240.             int VideoFrequency: MOVIE_50HZ - 50 Hz video output
  241.                                 MOVIE_60HZ - 60 Hz video output
  242.  
  243.         Return Value:
  244.  
  245.             None.
  246.  
  247.         -------------------------------------------------------------------
  248.  
  249.         Prototype:
  250.  
  251.             void FAR PASCAL MOVIE_SetDisplayPosition(WORD DisplayX,
  252.                                                      WORD DisplayY);
  253.  
  254.         Description:
  255.  
  256.             Set the display position of video output.
  257.  
  258.         Parameters:
  259.  
  260.             int DisplayX - The upper-left position video output (10~255)
  261.             int DisplayY - The upper-top  position video output (1~255)
  262.  
  263.         Return Value:
  264.  
  265.             None.
  266.  
  267.         -------------------------------------------------------------------
  268.  
  269.         Prototype:
  270.  
  271.             void FAR PASCAL MOVIE_MovieNotify(HWND wnd,WORD CommandID);
  272.  
  273.         Description:
  274.  
  275.             Notification when one of the following conditions is occurs:
  276.  
  277.                 . End of file
  278.                 . Reading error
  279.                 . Video decoding error
  280.                 . Audio decoding error
  281.  
  282.         Parameters:
  283.  
  284.             HWND wnd       - Window to be notified.
  285.             WORD CommandID - the word parameter value of WM_COMMAND message.
  286.  
  287.         Return Value:
  288.  
  289.             None.
  290.  
  291.         -------------------------------------------------------------------
  292.  
  293.         Prototype:
  294.  
  295.             void FAR PASCAL MOVIE_PTSNotify(HWND wnd,WORD CommandID);
  296.  
  297.         Description:
  298.  
  299.             Send the current PTS (Presentation Time Stamp) to the specified
  300.             window.
  301.             The lParam contain the PTS (The PTS is a counter of 90K Hz).
  302.             This function is enabled when the PTSNotify is set to 1 in the
  303.             MPMOVIE.INI.
  304.  
  305.             [Setting]
  306.             ...
  307.             PTSNotify=1
  308.             ...
  309.  
  310.         Parameters:
  311.  
  312.             HWND wnd       - Window to be notified.
  313.             WORD CommandID - the word parameter value.
  314.  
  315.         Return Value:
  316.  
  317.             None.
  318.  
  319.         -------------------------------------------------------------------
  320.  
  321.         Prototype:
  322.  
  323.             void FAR PASCAL MOVIE_EOFNotify(HWND wnd,WORD message,
  324.                                             WORD wparam,DWORD lparam);
  325.  
  326.         Description:
  327.  
  328.             Notification when enf of file.
  329.  
  330.         Parameters:
  331.  
  332.             HWND  wnd     - the Window to be notified.
  333.             WORD  message - the message to be sent to the Windows.
  334.             WORD  wparam  - the WORD parameter to be sent to the Windows.
  335.             DWORD lparam  - the DWORD parameter to be sent to the Windows.
  336.  
  337.         Return Value:
  338.  
  339.             None.
  340.  
  341.         -------------------------------------------------------------------
  342.  
  343.         Prototype:
  344.  
  345.             int  FAR PASCAL MOVIE_CDROM_Installed(void);
  346.  
  347.         Description:
  348.  
  349.             Check the CD-ROM drive is installed or not.
  350.  
  351.         Parameters:
  352.  
  353.             None.
  354.  
  355.         Return Value:
  356.  
  357.             0 : These is no CD-ROM drive in the system.
  358.             1 : The CD-ROM drive is installed.
  359.  
  360.         -------------------------------------------------------------------
  361.  
  362.         Prototype:
  363.  
  364.             int  FAR PASCAL MOVIE_CDROM_HasDisc(void);
  365.  
  366.         Description:
  367.  
  368.             Check there is disc in the CD-ROM drive or not.
  369.  
  370.         Parameters:
  371.  
  372.             None.
  373.  
  374.         Return Value:
  375.  
  376.             0 : These is no disc in the CD-ROM drive.
  377.             1 : These is a disc in the CD-ROM drive.
  378.  
  379.         -------------------------------------------------------------------
  380.  
  381.         Prototype:
  382.  
  383.             int  FAR PASCAL MOVIE_CDROM_IsDiscChanged(void);
  384.  
  385.         Description:
  386.  
  387.             Check the disc is changed or not.
  388.  
  389.         Parameters:
  390.  
  391.             None.
  392.  
  393.         Return Value:
  394.  
  395.             0 : The disc is not changed.
  396.             1 : The disc is changed.
  397.  
  398.         -------------------------------------------------------------------
  399.  
  400.         Prototype:
  401.  
  402.             int  FAR PASCAL MOVIE_CDROM_GetTrackNo(BYTE far * StartTrack,
  403.                                                    BYTE far * EndTrack);
  404.  
  405.         Description:
  406.  
  407.             Get the start and end track number of the disc in the CD-ROM
  408.             drive.
  409.  
  410.         Parameters:
  411.  
  412.             BYTE far * StartTrack - the start track number returned.
  413.             BYTE far * EndTrack   - the end track number returned.
  414.  
  415.         Return Value:
  416.  
  417.             0 : Failed
  418.             1 : Successed
  419.  
  420.         -------------------------------------------------------------------
  421.  
  422.         Prototype:
  423.  
  424.             int  FAR PASCAL MOVIE_CDROM_SeekTrack(BYTE TrackNo);
  425.  
  426.         Description:
  427.  
  428.             Seek to the begin of specified track number.
  429.  
  430.         Parameters:
  431.  
  432.             BYTE TrackNo - The track number
  433.  
  434.         Return Value:
  435.  
  436.             0 : Failed
  437.             1 : Successed
  438.  
  439.         -------------------------------------------------------------------
  440.  
  441.         Prototype:
  442.  
  443.             int  FAR PASCAL MOVIE_CDROM_SeekCDI(void);
  444.  
  445.         Description:
  446.  
  447.             Seek to the begin the CD-I disc.
  448.  
  449.         Parameters:
  450.  
  451.             None.
  452.  
  453.         Return Value:
  454.  
  455.             0      : Successed
  456.             Others : Error code.
  457.  
  458.         -------------------------------------------------------------------
  459.  
  460.         Prototype:
  461.  
  462.             void FAR PASCAL MOVIE_CDROM_GetCDITitle(char far *title);
  463.  
  464.         Description:
  465.  
  466.             Get the title name of the CD-I disc.
  467.  
  468.         Parameters:
  469.  
  470.             char far *title - CD-I title name returned.
  471.  
  472.         Return Value:
  473.  
  474.             0 : Failed
  475.             1 : Successed
  476.  
  477.         -------------------------------------------------------------------
  478.  
  479.         Prototype:
  480.  
  481.             int FAR PASCAL MOVIE_VGA_Output(int flag);
  482.  
  483.         Description:
  484.  
  485.             Select the MPEG video output or VGA video output.
  486.  
  487.         Parameters:
  488.  
  489.             int flag = 0 : MPEG video output
  490.                        1 : VGA video output
  491.  
  492.         Return Value:
  493.  
  494.             None.
  495.  
  496.