include/xapo.idl

   1 /*
   2  * Copyright (c) 2015 Andrew Eikum for CodeWeavers
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 import "unknwn.idl";
  20
  21 #define XAPO_REGISTRATION_STRING_LENGTH 256
  22
  23 cpp_quote("#if 0")
  24 typedef struct WAVEFORMATEX
  25 {
  26     WORD wFormatTag;
  27     WORD nChannels;
  28     DWORD nSamplesPerSec;
  29     DWORD nAvgBytesPerSec;
  30     WORD nBlockAlign;
  31     WORD wBitsPerSample;
  32     WORD cbSize;
  33 } WAVEFORMATEX;
  34
  35 typedef struct {
  36     WAVEFORMATEX    Format;
  37     union {
  38         WORD        wValidBitsPerSample;
  39         WORD        wSamplesPerBlock;
  40         WORD        wReserved;
  41     } Samples;
  42     DWORD           dwChannelMask;
  43     GUID            SubFormat;
  44 } WAVEFORMATEXTENSIBLE, *PWAVEFORMATEXTENSIBLE;
  45 cpp_quote("#else")
  46 cpp_quote("#include <mmreg.h>")
  47 cpp_quote("#endif")
  48
  49 typedef struct XAPO_REGISTRATION_PROPERTIES
  50 {
  51     CLSID clsid;
  52     WCHAR FriendlyName[XAPO_REGISTRATION_STRING_LENGTH];
  53     WCHAR CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH];
  54     UINT32 MajorVersion;
  55     UINT32 MinorVersion;
  56     UINT32 Flags;
  57     UINT32 MinInputBufferCount;
  58     UINT32 MaxInputBufferCount;
  59     UINT32 MinOutputBufferCount;
  60     UINT32 MaxOutputBufferCount;
  61 } XAPO_REGISTRATION_PROPERTIES;
  62
  63 typedef struct XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS {
  64     const WAVEFORMATEX *pFormat;
  65     UINT32 MaxFrameCount;
  66 } XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS;
  67
  68 typedef enum XAPO_BUFFER_FLAGS {
  69     XAPO_BUFFER_SILENT,
  70     XAPO_BUFFER_VALID
  71 } XAPO_BUFFER_FLAGS;
  72
  73 typedef struct XAPO_PROCESS_BUFFER_PARAMETERS {
  74     void *pBuffer;
  75     XAPO_BUFFER_FLAGS BufferFlags;
  76     UINT32 ValidFrameCount;
  77 } XAPO_PROCESS_BUFFER_PARAMETERS;
  78
  79 /* XAudio2 2.8 version of IXAPO */
  80 [
  81     object,
  82     local,
  83     uuid(a410b984-9839-4819-a0be-2856ae6b3adb)
  84 ]
  85 interface IXAPO : IUnknown
  86 {
  87     HRESULT GetRegistrationProperties([out] XAPO_REGISTRATION_PROPERTIES **props);
  88
  89     HRESULT IsInputFormatSupported(const WAVEFORMATEX *output_fmt,
  90         const WAVEFORMATEX *input_fmt, WAVEFORMATEX **supported_fmt);
  91
  92     HRESULT IsOutputFormatSupported(const WAVEFORMATEX *input_fmt,
  93         const WAVEFORMATEX *output_fmt, WAVEFORMATEX **supported_fmt);
  94
  95     HRESULT Initialize(const void *data, UINT32 data_len);
  96
  97     HRESULT Reset(void);
  98
  99     HRESULT LockForProcess(UINT32 in_params_count, const XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS *in_params,
 100         UINT32 out_params_count, const XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS *out_params);
 101
 102     void UnlockForProcess(void);
 103
 104     void Process(UINT32 in_params_count, const XAPO_PROCESS_BUFFER_PARAMETERS *in_params,
 105         UINT32 out_params_count, const XAPO_PROCESS_BUFFER_PARAMETERS *out_params,
 106         BOOL enabled);
 107
 108     UINT32 CalcInputFrames(UINT32 output_frames);
 109
 110     UINT32 CalcOutputFrames(UINT32 input_frames);
 111 }
 112
 113 /* XAudio2 2.7 version of IXAPO is identical to 2.8 */
 114 cpp_quote("DEFINE_GUID(IID_IXAPO27, 0xa90bc001, 0xe897, 0xe897, 0x55, 0xe4, 0x9e, 0x47, 0x00, 0x00, 0x00, 0x00);")
 115
 116
 117 /* XAudio2 2.8 version of IXAPOParameters */
 118 [
 119     object,
 120     local,
 121     uuid(26d95c66-80f2-499a-ad54-5ae7f01c6d98)
 122 ]
 123 interface IXAPOParameters : IUnknown
 124 {
 125     void SetParameters(const void *params, UINT32 params_len);
 126
 127     void GetParameters(void *params, UINT32 params_len);
 128 }
 129
 130 /* XAudio2 2.7 version of IXAPOParameters is identical to 2.8 */
 131 cpp_quote("DEFINE_GUID(IID_IXAPO27Parameters, 0xa90bc001, 0xe897, 0xe897, 0x55, 0xe4, 0x9e, 0x47, 0x00, 0x00, 0x00, 0x01);")