---

Out.h

#ifdef  __cplusplus
extern "C" {
#endif

#define OUT_VER 0x10

typedef struct 
{
  int version;        // module version (OUT_VER)
  char *description;      // description of module, with version string
  int id;           // module id. each input module gets its own. non-nullsoft modules should
                // be >= 65536. 

  HWND hMainWindow;     // winamp's main window (filled in by winamp)
  HINSTANCE hDllInstance;   // DLL instance handle (filled in by winamp)

  void (*Config)(HWND hwndParent); // configuration dialog 
  void (*About)(HWND hwndParent);  // about dialog

  void (*Init)();       // called when loaded
  void (*Quit)();       // called when unloaded

  int (*Open)(int samplerate, int numchannels, int bitspersamp, int bufferlenms, int prebufferms); 
          // returns >=0 on success, <0 on failure
          // NOTENOTENOTE: bufferlenms and prebufferms are ignored in most if not all output plug-ins. 
          //    ... so don't expect the max latency returned to be what you asked for.
          // returns max latency in ms (0 for diskwriters, etc)
          // bufferlenms and prebufferms must be in ms. 0 to use defaults. 
          // prebufferms must be <= bufferlenms

  void (*Close)();  // close the ol' output device.

  int (*Write)(char *buf, int len); 
          // 0 on success. Len == bytes to write (<= 8192 always). buf is straight audio data. 
          // 1 returns not able to write (yet). Non-blocking, always.

  int (*CanWrite)();  // returns number of bytes possible to write at a given time. 
            // Never will decrease unless you call Write (or Close, heh)

  int (*IsPlaying)(); // non0 if output is still going or if data in buffers waiting to be
            // written (i.e. closing while IsPlaying() returns 1 would truncate the song

  int (*Pause)(int pause); // returns previous pause state

  void (*SetVolume)(int volume); // volume is 0-255
  void (*SetPan)(int pan); // pan is -128 to 128

  void (*Flush)(int t); // flushes buffers and restarts output at time t (in ms) 
              // (used for seeking)

  int (*GetOutputTime)(); // returns played time in MS
  int (*GetWrittenTime)(); // returns time written in MS (used for synching up vis stuff)

#ifdef  __GNUC__
} __attribute__ ((packed)) Out_Module;
#else // __GNUC__
} Out_Module;
#endif // __GNUC__

#ifdef  __cplusplus
}
#endif

---