home *** CD-ROM | disk | FTP | other *** search
/ The Net: Ultimate Internet Guide / WWLCD1.ISO / pc / directx2 / sdk / samples / iklowns / mdsplay.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-05-28  |  2.1 KB  |  82 lines
  1. /**************************************************************************
  2.  
  3.     (C) Copyright 1995-1996 Microsoft Corp.  All rights reserved.
  4.  
  5.     You have a royalty-free right to use, modify, reproduce and 
  6.     distribute the Sample Files (and/or any modified version) in 
  7.     any way you find useful, provided that you agree that 
  8.     Microsoft has no warranty obligations or liability for any 
  9.     Sample Application Files which are modified. 
  10.  
  11.     we do not recomend you base your game on IKlowns, start with one of
  12.     the other simpler sample apps in the GDK
  13.  
  14.  **************************************************************************/
  15.  
  16. //
  17. // Public include file for MDSPlay.DLL
  18. //
  19.  
  20. // Returned errors
  21. //
  22. #define MDS_SUCCESS                 (0)
  23. #define MDS_ERR_NOMEM               (1)
  24. #define MDS_ERR_NOFILE              (2)
  25. #define MDS_ERR_BADFILE             (3)
  26. #define MDS_ERR_BADFLAGS            (4)
  27. #define MDS_ERR_MIDIERROR           (5)
  28. #define MDS_ERR_INVALHANDLE         (6)
  29. #define MDS_ERR_BADSTATE            (7)
  30.  
  31.  
  32. //
  33. // LoadMDSImage
  34. // 
  35. // Allocate space for and read the given image in preparation for playback.
  36. //
  37. // lpbImage may be freed after this call
  38. //
  39.  
  40. // One of these flags MUST be set
  41. //
  42. // lpbImage -> string containing filename 
  43. //
  44. #define MDS_F_FILENAME              0x00000001L
  45.  
  46. // lpbImage -> memory image of file
  47. //
  48. #define MDS_F_MEMORY                0x00000002L
  49.  
  50. // NOTE: cbImage only used if MDS_F_MEMORY is set.
  51. //
  52. DWORD LoadMDSImage(HANDLE *hImage, PBYTE pbImage, DWORD cbImage, DWORD fdw);
  53.  
  54. //
  55. // FreeMDSImage
  56. //
  57. // Release all memory associated with the given MDS image.
  58. //
  59. // If the given MDS is still playing, it will be stopped and the device
  60. // closed.
  61. //
  62. DWORD FreeMDSImage(HANDLE hImage);
  63. // 
  64. // Basic operations on the MDS image
  65. //
  66.  
  67. // Loop until told to stop
  68. //
  69. #define MDS_F_LOOP                  0x00000001L
  70.  
  71. // Play from beginning or last pause state.
  72. //
  73. DWORD PlayMDS(HANDLE hImage, DWORD fdw);
  74.  
  75. // Pause until next play
  76. //
  77. DWORD PauseMDS(HANDLE hImage);
  78.  
  79. // Stop. Next play will start at beginning of file again
  80. //
  81. DWORD StopMDS(HANDLE hImage);
  82.