include/icodecapi.idl

   1 /*
   2  * Copyright 2021 Alistair Leslie-Hughes
   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
  20 import "unknwn.idl";
  21 import "oaidl.idl";
  22
  23 interface IStream;
  24
  25 struct CodecAPIEventData
  26 {
  27     GUID  guid;
  28     DWORD dataLength;
  29     DWORD reserved[3];
  30 };
  31
  32 [
  33     uuid(901db4c7-31ce-41a2-85dc-8fa0bf41b8da),
  34     local,
  35     object,
  36     pointer_default(unique)
  37 ]
  38 interface ICodecAPI : IUnknown
  39 {
  40     HRESULT IsSupported ([in] const GUID *api);
  41     HRESULT IsModifiable ([in] const GUID *api);
  42
  43     HRESULT GetParameterRange ([in] const GUID *api, [out] VARIANT *min, [out] VARIANT *max, [out] VARIANT *delta);
  44     HRESULT GetParameterValues ([in] const GUID *api, [out, size_is(,*count)] VARIANT **values, [out] ULONG *count);
  45     HRESULT GetDefaultValue ([in] const GUID *api, [out] VARIANT *value);
  46
  47     HRESULT GetValue ([in] const GUID *api, [out] VARIANT *value);
  48     HRESULT SetValue ([in] const GUID *api, [in] VARIANT *value);
  49
  50     HRESULT RegisterForEvent ([in] const GUID *api, [in] LONG_PTR userData);
  51     HRESULT UnregisterForEvent ([in] const GUID *api);
  52
  53     HRESULT SetAllDefaults(void);
  54
  55     HRESULT SetValueWithNotify ([in] const GUID *api, [in] VARIANT *value, [out, size_is(,*count)] GUID **param, [out] ULONG *count);
  56
  57     HRESULT SetAllDefaultsWithNotify([out, size_is(,*count)] GUID **param, [out] ULONG *count);
  58
  59     HRESULT GetAllSettings([in] IStream *stream);
  60     HRESULT SetAllSettings([in] IStream *stream);
  61
  62     HRESULT SetAllSettingsWithNotify([in] IStream* stream, [out, size_is(,*count)] GUID **param, [out] ULONG *count);
  63 }