sdk/include/psdk/sti.h

   1 /*
   2  * Copyright (C) 2009 Damjan Jovanovic
   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 #ifndef __WINE_STI_H
  20 #define __WINE_STI_H
  21
  22 #include <objbase.h>
  23 /* #include <stireg.h> */
  24 /* #include <stierr.h> */
  25
  26 #include <pshpack8.h>
  27
  28 #ifdef __cplusplus
  29 extern "C" {
  30 #endif
  31
  32 DEFINE_GUID(CLSID_Sti, 0xB323F8E0L, 0x2E68, 0x11D0, 0x90, 0xEA, 0x00, 0xAA, 0x00, 0x60, 0xF8, 0x6C);
  33
  34 DEFINE_GUID(IID_IStillImageW, 0x641BD880, 0x2DC8, 0x11D0, 0x90, 0xEA, 0x00, 0xAA, 0x00, 0x60, 0xF8, 0x6C);
  35
  36 DEFINE_GUID(IID_IStillImageA, 0xA7B1F740, 0x1D7F, 0x11D1, 0xAC, 0xA9, 0x00, 0xA0, 0x24, 0x38, 0xAD, 0x48);
  37
  38 #define STI_VERSION_REAL         0x00000002
  39 #define STI_VERSION_FLAG_UNICODE 0x01000000
  40
  41 #ifndef WINE_NO_UNICODE_MACROS
  42 # ifdef UNICODE
  43 #  define STI_VERSION (STI_VERSION_REAL | STI_VERSION_FLAG_UNICODE)
  44 # else
  45 #  define STI_VERSION (STI_VERSION_REAL)
  46 # endif
  47 #endif
  48
  49 typedef struct IStillImageA *PSTIA;
  50 typedef struct IStillImageW *PSTIW;
  51 DECL_WINELIB_TYPE_AW(PSTI)
  52 typedef struct IStillImageA *LPSTILLIMAGEA;
  53 typedef struct IStillImageW *LPSTILLIMAGEW;
  54 DECL_WINELIB_TYPE_AW(LPSTILLIMAGE)
  55 typedef struct IStiDeviceA *PSTIDEVICEA;
  56 typedef struct IStiDeviceW *PSTIDEVICEW;
  57 DECL_WINELIB_TYPE_AW(PSTIDEVICE)
  58
  59 HRESULT WINAPI StiCreateInstanceA(HINSTANCE hinst, DWORD dwVer, PSTIA *ppSti, LPUNKNOWN pUnkOuter);
  60 HRESULT WINAPI StiCreateInstanceW(HINSTANCE hinst, DWORD dwVer, PSTIW *ppSti, LPUNKNOWN pUnkOuter);
  61 #define        StiCreateInstance WINELIB_NAME_AW(StiCreateInstance)
  62
  63 typedef DWORD STI_DEVICE_TYPE;
  64 typedef enum _STI_DEVICE_MJ_TYPE
  65 {
  66     StiDeviceTypeDefault           = 0,
  67     StiDeviceTypeScanner           = 1,
  68     StiDeviceTypeDigitalCamera     = 2,
  69     StiDeviceTypeStreamingVideo    = 3
  70 } STI_DEVICE_MJ_TYPE;
  71
  72 #define GET_STIDEVICE_TYPE(dwDevType) HIWORD(dwDevType)
  73 #define GET_STIDEVICE_SUBTYPE(dwDevType) LOWORD(dwDevType)
  74
  75 typedef struct _STI_DEV_CAPS {
  76     DWORD dwGeneric;
  77 } STI_DEV_CAPS, *PSTI_DEV_CAPS;
  78
  79 #define STI_MAX_INTERNAL_NAME_LENGTH 128
  80
  81 typedef struct _STI_DEVICE_INFORMATIONW {
  82     DWORD dwSize;
  83     STI_DEVICE_TYPE DeviceType;
  84     WCHAR szDeviceInternalName[STI_MAX_INTERNAL_NAME_LENGTH];
  85     STI_DEV_CAPS DeviceCapabilities;
  86     DWORD dwHardwareConfiguration;
  87     LPWSTR pszVendorDescription;
  88     LPWSTR pszDeviceDescription;
  89     LPWSTR pszPortName;
  90     LPWSTR pszPropProvider;
  91     LPWSTR pszLocalName;
  92 } STI_DEVICE_INFORMATIONW, *PSTI_DEVICE_INFORMATIONW;
  93
  94 typedef STI_DEVICE_INFORMATIONW STI_DEVICE_INFORMATION;
  95 typedef PSTI_DEVICE_INFORMATIONW PSTI_DEVICE_INFORMATION;
  96
  97 #define MAX_NOTIFICATION_DATA 64
  98
  99 typedef struct _STINOTIFY {
 100     DWORD dwSize;
 101     GUID guidNotificationCode;
 102     BYTE abNotificationData[MAX_NOTIFICATION_DATA];
 103 } STINOTIFY,*LPSTINOTIFY;
 104
 105 #define INTERFACE IStillImageW
 106 DECLARE_INTERFACE_(IStillImageW, IUnknown)
 107 {
 108     /*** IUnknown methods ***/
 109     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
 110     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
 111     STDMETHOD_(ULONG,Release)(THIS) PURE;
 112     /*** IStillImageW methods ***/
 113     STDMETHOD(Initialize)(THIS_ HINSTANCE hinst, DWORD dwVersion) PURE;
 114     STDMETHOD(GetDeviceList)(THIS_ DWORD dwType, DWORD dwFlags, DWORD *pdwItemsReturned, LPVOID *ppBuffer) PURE;
 115     STDMETHOD(GetDeviceInfo)(THIS_ LPWSTR pwszDeviceName, LPVOID *ppBuffer) PURE;
 116     STDMETHOD(CreateDevice)(THIS_ LPWSTR pwszDeviceName, DWORD dwMode, PSTIDEVICEW *pDevice, LPUNKNOWN pUnkOuter) PURE;
 117     STDMETHOD(GetDeviceValue)(THIS_ LPWSTR pwszDeviceName, LPWSTR pValueName, LPDWORD pType, LPBYTE pData, LPDWORD cbData) PURE;
 118     STDMETHOD(SetDeviceValue)(THIS_ LPWSTR pwszDeviceName, LPWSTR pValueName, DWORD type, LPBYTE pData, DWORD cbData) PURE;
 119     STDMETHOD(GetSTILaunchInformation)(THIS_ LPWSTR pwszDeviceName, DWORD *pdwEventCode, LPWSTR pwszEventName) PURE;
 120     STDMETHOD(RegisterLaunchApplication)(THIS_ LPWSTR pwszAppName, LPWSTR pwszCommandLine) PURE;
 121     STDMETHOD(UnregisterLaunchApplication)(THIS_ LPWSTR pwszAppName) PURE;
 122     STDMETHOD(EnableHwNotifications)(THIS_ LPCWSTR pwszDeviceName, BOOL bNewState) PURE;
 123     STDMETHOD(GetHwNotificationState)(THIS_ LPCWSTR pwszDeviceName, BOOL *pbCurrentState) PURE;
 124     STDMETHOD(RefreshDeviceBus)(THIS_ LPCWSTR pwszDeviceName) PURE;
 125     STDMETHOD(LaunchApplicationForDevice)(THIS_ LPWSTR pwszDeviceName, LPWSTR pwszAppName, LPSTINOTIFY pStiNotify);
 126     STDMETHOD(SetupDeviceParameters)(THIS_ PSTI_DEVICE_INFORMATIONW pDevInfo);
 127     STDMETHOD(WriteToErrorLog)(THIS_ DWORD dwMessageType, LPCWSTR pszMessage) PURE;
 128 };
 129 #undef INTERFACE
 130
 131 #if !defined(__cplusplus) || defined(CINTERFACE)
 132 /*** IUnknown methods ***/
 133 #define IStillImage_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
 134 #define IStillImage_AddRef(p)             (p)->lpVtbl->AddRef(p)
 135 #define IStillImage_Release(p)            (p)->lpVtbl->Release(p)
 136 /*** IStillImage methods ***/
 137 #define IStillImage_Initialize(p,a,b)                   (p)->lpVtbl->Initialize(p,a,b)
 138 #define IStillImage_GetDeviceList(p,a,b,c,d)            (p)->lpVtbl->GetDeviceList(p,a,b,c,d)
 139 #define IStillImage_GetDeviceInfo(p,a,b)                (p)->lpVtbl->GetDeviceInfo(p,a,b)
 140 #define IStillImage_CreateDevice(p,a,b,c,d)             (p)->lpVtbl->CreateDevice(p,a,b,c,d)
 141 #define IStillImage_GetDeviceValue(p,a,b,c,d,e)         (p)->lpVtbl->GetDeviceValue(p,a,b,c,d,e)
 142 #define IStillImage_SetDeviceValue(p,a,b,c,d,e)         (p)->lpVtbl->SetDeviceValue(p,a,b,c,d,e)
 143 #define IStillImage_GetSTILaunchInformation(p,a,b,c)    (p)->lpVtbl->GetSTILaunchInformation(p,a,b,c)
 144 #define IStillImage_RegisterLaunchApplication(p,a,b)    (p)->lpVtbl->RegisterLaunchApplication(p,a,b)
 145 #define IStillImage_UnregisterLaunchApplication(p,a)    (p)->lpVtbl->UnregisterLaunchApplication(p,a)
 146 #define IStillImage_EnableHwNotifications(p,a,b)        (p)->lpVtbl->EnableHwNotifications(p,a,b)
 147 #define IStillImage_GetHwNotificationState(p,a,b)       (p)->lpVtbl->GetHwNotificationState(p,a,b)
 148 #define IStillImage_RefreshDeviceBus(p,a)               (p)->lpVtbl->RefreshDeviceBus(p,a)
 149 #define IStillImage_LaunchApplicationForDevice(p,a,b,c) (p)->lpVtbl->LaunchApplicationForDevice(p,a,b,c)
 150 #define IStillImage_SetupDeviceParameters(p,a)          (p)->lpVtbl->SetupDeviceParameters(p,a)
 151 #define IStillImage_WriteToErrorLog(p,a,b)              (p)->lpVtbl->WriteToErrorLog(p,a,b)
 152 #else
 153 /*** IUnknown methods ***/
 154 #define IStillImage_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
 155 #define IStillImage_AddRef(p)             (p)->AddRef()
 156 #define IStillImage_Release(p)            (p)->Release()
 157 /*** IStillImage methods ***/
 158 #define IStillImage_Initialize(p,a,b)                   (p)->Initialize(a,b)
 159 #define IStillImage_GetDeviceList(p,a,b,c,d)            (p)->GetDeviceList(a,b,c,d)
 160 #define IStillImage_GetDeviceInfo(p,a,b)                (p)->GetDeviceInfo(a,b)
 161 #define IStillImage_CreateDevice(p,a,b,c,d)             (p)->CreateDevice(a,b,c,d)
 162 #define IStillImage_GetDeviceValue(p,a,b,c,d,e)         (p)->GetDeviceValue(a,b,c,d,e)
 163 #define IStillImage_SetDeviceValue(p,a,b,c,d,e)         (p)->SetDeviceValue(a,b,c,d,e)
 164 #define IStillImage_GetSTILaunchInformation(p,a,b,c)    (p)->GetSTILaunchInformation(a,b,c)
 165 #define IStillImage_RegisterLaunchApplication(p,a,b)    (p)->RegisterLaunchApplication(a,b)
 166 #define IStillImage_UnregisterLaunchApplication(p,a)    (p)->UnregisterLaunchApplication(a)
 167 #define IStillImage_EnableHwNotifications(p,a,b)        (p)->EnableHwNotifications(a,b)
 168 #define IStillImage_GetHwNotificationState(p,a,b)       (p)->GetHwNotificationState(a,b)
 169 #define IStillImage_RefreshDeviceBus(p,a)               (p)->RefreshDeviceBus(a)
 170 #define IStillImage_LaunchApplicationForDevice(p,a,b,c) (p)->LaunchApplicationForDevice(a,b,c)
 171 #define IStillImage_SetupDeviceParameters(p,a)          (p)->SetupDeviceParameters(a)
 172 #define IStillImage_WriteToErrorLog(p,a,b)              (p)->WriteToErrorLog(a,b)
 173 #endif
 174
 175 #ifdef __cplusplus
 176 }
 177 #endif
 178
 179 #include <poppack.h>
 180
 181 #endif /* __WINE_STI_H */