/**************************************************************************** * * (C) COPYRIGHT 1998-2000, MICROSOFT CORP. * * FILE: wiamindr.idl * * VERSION: 2.0 * * DATE: 8/28/1998 * * DESCRIPTION: * IDL source for the WIA mini driver. * *****************************************************************************/ interface IWiaMiniDrv; interface IWiaMiniDrvCallBack; interface IWiaDrvItem; interface IWiaItem; interface IWiaPropertyStorage; import "unknwn.idl"; import "oaidl.idl"; import "propidl.idl"; import "wia.idl"; /**************************************************************************\ * * MINIDRV_TRANSFER_CONTEXT - Minidriver data transfer context * \**************************************************************************/ typedef struct _MINIDRV_TRANSFER_CONTEXT{ LONG lSize; LONG lWidthInPixels; LONG lLines; LONG lDepth; LONG lXRes; LONG lYRes; LONG lCompression; GUID guidFormatID; LONG tymed; LONG hFile; LONG cbOffset; LONG lBufferSize; LONG lActiveBuffer; LONG lNumBuffers; BYTE *pBaseBuffer; BYTE *pTransferBuffer; BOOL bTransferDataCB; BOOL bClassDrvAllocBuf; LONG lClientAddress; IWiaMiniDrvCallBack *pIWiaMiniDrvCallBack; LONG lImageSize; LONG lHeaderSize; LONG lItemSize; LONG cbWidthInBytes; LONG lPage; LONG lCurIfdOffset; LONG lPrevIfdOffset; } MINIDRV_TRANSFER_CONTEXT, *PMINIDRV_TRANSFER_CONTEXT; /******************************************************************************* * * WIA_DEV_CAP_DRV - Device capabilities * *******************************************************************************/ typedef struct _WIA_DEV_CAP_DRV { GUID *guid; ULONG ulFlags; LPOLESTR wszName; LPOLESTR wszDescription; LPOLESTR wszIcon; } WIA_DEV_CAP_DRV,*PWIA_DEV_CAP_DRV; /******************************************************************************* * * IWiaMiniDrvItem interface * *******************************************************************************/ [ object, uuid(d8cdee14-3c6c-11d2-9a35-00c04fa36145), helpstring("WIA Mini Driver Interface"), pointer_default(unique) ] interface IWiaMiniDrv : IUnknown { [helpstring("Initialize WIA, build item tree, etc")] HRESULT drvInitializeWia( [in] BYTE*, [in] LONG, [in] BSTR, [in] BSTR, [in] IUnknown*, [in] IUnknown*, [out] IWiaDrvItem**, [out] IUnknown**, [out] LONG*); [helpstring("Acquire data from the device item")] HRESULT drvAcquireItemData( [in] BYTE*, [in] LONG, [in, out] PMINIDRV_TRANSFER_CONTEXT, [out] LONG*); [helpstring("Initialize the device item properties")] HRESULT drvInitItemProperties( [in] BYTE*, [in] LONG, [out] LONG*); [helpstring("Mini driver validatation of the device item properties")] HRESULT drvValidateItemProperties( [in] BYTE*, [in] LONG, [in] ULONG, [in] const PROPSPEC*, [out] LONG*); [helpstring("Mini driver write of the device item properties")] HRESULT drvWriteItemProperties( [in] BYTE*, [in] LONG, [in] PMINIDRV_TRANSFER_CONTEXT, [out] LONG*); [helpstring("Mini driver read of the device item properties")] HRESULT drvReadItemProperties( [in] BYTE*, [in] LONG, [in] ULONG, [in] const PROPSPEC*, [out] LONG*); [helpstring("Lock Device")] HRESULT drvLockWiaDevice( [in] BYTE*, [in] LONG, [out] LONG*); [helpstring("UnLock Device")] HRESULT drvUnLockWiaDevice( [in] BYTE*, [in] LONG, [out] LONG*); [helpstring("Look at item and create sub-items if needed")] HRESULT drvAnalyzeItem( [in] BYTE*, [in] LONG, [in] LONG*); [helpstring("Map a device error value to a string")] HRESULT drvGetDeviceErrorStr( [in] LONG, [in] LONG, [out] LPOLESTR*, [out] LONG*); [helpstring("Issue a device command")] HRESULT drvDeviceCommand( [in] BYTE*, [in] LONG, [in] const GUID*, [out] IWiaDrvItem**, [out] LONG*); [helpstring("Get the device capabilities")] HRESULT drvGetCapabilities( [in] BYTE*, [in] LONG, [out] LONG*, [out] WIA_DEV_CAP_DRV**, [out] LONG*); [helpstring("Delete the item from the device")] HRESULT drvDeleteItem( [in] BYTE*, [in] LONG, [out] LONG*); [helpstring("Free driver item context")] HRESULT drvFreeDrvItemContext( [in] LONG, [in] BYTE*, [out] LONG*); [helpstring("Get the FORMAT and TYMED")] HRESULT drvGetWiaFormatInfo( [in] BYTE*, [in] LONG, [out] LONG*, [out] WIA_FORMAT_INFO**, [out] LONG*); [helpstring("Notify Pnp event received by device manager")] HRESULT drvNotifyPnpEvent( [in] const GUID *pEventGUID, [in] BSTR bstrDeviceID, [in] ULONG ulReserved); [helpstring("UnInitialize WIA, remove resources attached to item, etc")] HRESULT drvUnInitializeWia( [in] BYTE*); }; /******************************************************************************* * * IWiaMiniDrvCallBack interface * *******************************************************************************/ [ object, uuid(33a57d5a-3de8-11d2-9a36-00c04fa36145), helpstring("WIA Mini Driver Call Back Interface"), pointer_default(unique) ] interface IWiaMiniDrvCallBack : IUnknown { [id(1), helpstring("Acquire data from the device")] HRESULT MiniDrvCallback( [in] LONG lReason, [in] LONG lStatus, [in] LONG lPercentComplete, [in] LONG lOffset, [in] LONG lLength, [in] PMINIDRV_TRANSFER_CONTEXT pTranCtx, [in] LONG lReserved); }; /**************************************************************************\ * * IWiaDrvItem interface * \**************************************************************************/ [ object, uuid(1f02b5c5-b00c-11d2-a094-00c04f72dc3c), helpstring("WIA Mini Driver DrvItem Interface"), pointer_default(unique) ] interface IWiaDrvItem : IUnknown { HRESULT GetItemFlags( [out] LONG*); HRESULT GetDeviceSpecContext( [out] BYTE**); HRESULT GetFullItemName( [out] BSTR*); HRESULT GetItemName( [out] BSTR*); HRESULT AddItemToFolder( [in] IWiaDrvItem*); HRESULT UnlinkItemTree( [in] LONG); HRESULT RemoveItemFromFolder( [in] LONG); HRESULT FindItemByName( [in] LONG, [in] BSTR, [out] IWiaDrvItem**); HRESULT FindChildItemByName( [in] BSTR, [out] IWiaDrvItem**); HRESULT GetParentItem( [out] IWiaDrvItem**); HRESULT GetFirstChildItem( [out] IWiaDrvItem**); HRESULT GetNextSiblingItem( [out] IWiaDrvItem**); HRESULT DumpItemData( [out] BSTR*); }; /******************************************************************************* * * WIA_PROPERTY_INFO - Stores default access and valid values for item properties * *******************************************************************************/ typedef struct _WIA_PROPERTY_INFO { ULONG lAccessFlags; VARTYPE vt; union { struct { LONG Min; LONG Nom; LONG Max; LONG Inc; } Range; struct { DOUBLE Min; DOUBLE Nom; DOUBLE Max; DOUBLE Inc; } RangeFloat; struct { LONG cNumList; LONG Nom; BYTE *pList; } List; struct { LONG cNumList; DOUBLE Nom; BYTE *pList; } ListFloat; struct { LONG cNumList; GUID Nom; GUID *pList; } ListGuid; struct { LONG cNumList; BSTR Nom; BSTR *pList; } ListBStr; struct { LONG Nom; LONG ValidBits; } Flag; struct { LONG Dummy; } None; } ValidVal; }WIA_PROPERTY_INFO, *PWIA_PROPERTY_INFO; /******************************************************************************* * * WIA_PROPERTY_CONTEXT - Stores property id and flag indicating whether the * application is changing the property * *******************************************************************************/ typedef struct _WIA_PROPERTY_CONTEXT{ ULONG cProps; PROPID *pProps; BOOL *pChanged; } WIA_PROPERTY_CONTEXT, *PWIA_PROPERTY_CONTEXT; /******************************************************************************* * * WIAS_CHANGED_VALUE_INFO - Stores current and previous values for a property * *******************************************************************************/ typedef struct _WIAS_CHANGED_VALUE_INFO{ BOOL bChanged; LONG vt; union { LONG lVal; FLOAT fltVal; BSTR bstrVal; GUID guidVal; } Old; union { LONG lVal; FLOAT fltVal; BSTR bstrVal; GUID guidVal; } Current; } WIAS_CHANGED_VALUE_INFO, *PWIAS_CHANGED_VALUE_INFO; /******************************************************************************* * * WIAS_DOWN_SAMPLE_INFO - Used by wiasDownSampleBuffer * *******************************************************************************/ typedef struct _WIAS_DOWN_SAMPLE_INFO { ULONG ulOriginalWidth; ULONG ulOriginalHeight; ULONG ulBitsPerPixel; ULONG ulXRes; ULONG ulYRes; ULONG ulDownSampledWidth; ULONG ulDownSampledHeight; ULONG ulActualSize; ULONG ulDestBufSize; ULONG ulSrcBufSize; BYTE *pSrcBuffer; BYTE *pDestBuffer; } WIAS_DOWN_SAMPLE_INFO, *PWIAS_DOWN_SAMPLE_INFO; /******************************************************************************* * * WIAS_ENDORSER_VALUE - Stores endorser strings * *******************************************************************************/ typedef struct _WIAS_ENDORSER_VALUE { LPWSTR wszTokenName; LPWSTR wszValue; } WIAS_ENDORSER_VALUE, *PWIAS_ENDORSER_VALUE; /******************************************************************************* * * WIAS_ENDORSER_INFO - Stores token/value pairs for endorser * *******************************************************************************/ typedef struct _WIAS_ENDORSER_INFO { ULONG ulPageCount; ULONG ulNumEndorserValues; WIAS_ENDORSER_VALUE *pEndorserValues; } WIAS_ENDORSER_INFO, *PWIAS_ENDORSER_INFO; cpp_quote("#include \"wiamdef.h\"")