cdapi.h

佳能数码相机 SDK 7.3 开发包 VC++代码 含英文说明文档

#ifndef _CD_API_H_
#define _CD_API_H_

#include "cdType.h"
#include "cdFncTyp.h"
#include "cdEvent.h"
#include "cdError.h"

#ifdef macintosh
 #if PRAGMA_STRUCT_ALIGN
  #pragma options align=mac68k
 #endif
#endif

#ifdef __cplusplus
extern "C" {
#endif

/****************************************************************************
 ****************************************************************************
 *             Canon Digital Camera SDK : Function Definitions              *
 *                            For Version 7.1                               *
 ****************************************************************************
 ****************************************************************************/

/*-----------------------------------------------------------------------
   Basic Functions 
------------------------------------------------------------------------*/

cdCAPI CDStartSDK( 
	cdVersionInfo*	pVersion,
	cdUInt32		Option
);

cdCAPI CDFinishSDK();

cdCAPI CDGetSDKVersion(
	cdVersionInfo*	pVersion
);

cdCAPI CDGetFunctions (
	cdFunctions *	pFunctions
);


/*-----------------------------------------------------------------------
   Source Control Functions
------------------------------------------------------------------------*/

cdCAPI CDEnumDeviceReset(
	cdUInt32		Kind,
	cdHEnum*		phEnum	
);

cdCAPI CDEnumDeviceNext(
	cdHEnum			hEnum,	
	cdSourceInfo* 	pSourceInfo
);

cdCAPI CDGetDeviceCount (
	cdHEnum			hEnum,
	cdUInt32*		pCount
);

cdCAPI CDEnumDeviceRelease (
	cdHEnum			hEnum
);

cdCAPI CDOpenSource( 
	cdSourceInfo*	pSourceInfo,
	cdHSource*		phSource
);

cdCAPI CDCloseSource(
	cdHSource		hSource
);

cdCAPI CDRegisterEventCallbackFunction(
	cdHSource					hSource,
	cdEventCallbackFunction*	pFunc,
	cdContext					Context,
	cdHandle*					phFunc
);

cdCAPI CDUnregisterEventCallbackFunction(
	cdHSource					hSource,
	cdHandle					hFunc
);


/*-----------------------------------------------------------------------
   Device Management Functions 
------------------------------------------------------------------------*/

cdCAPI CDEnumDevicePropertyReset (
	cdHSource				hSource,
	cdUInt32				Option,
	cdHEnum*				phEnum
);

cdCAPI CDEnumDevicePropertyNext (
	cdHEnum					hEnum,
	cdDevicePropertyStruct*	pDevPropStruct
);

cdCAPI CDGetDevicePropertyCount (
	cdHEnum					hEnum,
	cdUInt32*				pCount
);

cdCAPI CDEnumDevicePropertyRelease (
	cdHEnum					hEnum
);

cdCAPI CDGetDevicePropertyData(
	cdHSource				hSource,
	cdDevicePropertyID 		DevPropID,
	cdUInt32*				pBufSize,
	cdVoid*					pBuf,
	cdUInt32				Option
);

cdCAPI CDSetDevicePropertyData(
	cdHSource				hSource,
	cdDevicePropertyID  	DevPropID,
	cdUInt32*				pBufSize,
	cdVoid*					pBuf
);

cdCAPI CDEnumSupportedImageSizeReset(
	cdHSource				hSource,
	cdUInt32				Option,
	cdHEnum*				phEnum
);

cdCAPI CDEnumSupportedImageSizeNext(
	cdHEnum					hEnum,
	cdImageSizeSpec*		pSpec
);

cdCAPI CDGetSupportedImageSizeCount (
	cdHEnum					hEnum,
	cdUInt32*				pCount
);

cdCAPI CDEnumSupportedImageSizeRelease (
	cdHEnum					hEnum
);

cdCAPI CDLockUI(
	cdHSource				hSource
);

cdCAPI CDUnlockUI(
	cdHSource				hSource
);

cdCAPI CDSetUILockTimeOutTime(
	cdHSource				hSource,
	cdUInt32				Time
);

cdCAPI CDFormat(
	cdHVolume				hVolume
);


/*-----------------------------------------------------------------------
   Collect Functions  
------------------------------------------------------------------------*/

cdCAPI CDEnumVolumeReset(		
	cdHSource			hSource,
	cdHEnum*			phEnum
);

cdCAPI CDEnumVolumeNext(
	cdHEnum				hEnum,
	cdHVolume *			phVolume
);

cdCAPI CDGetVolumeCount(
	cdHEnum				hEnum,
	cdUInt32*			pCount		
);

cdCAPI CDEnumVolumeRelease(
	cdHEnum				hEnum
);

cdCAPI CDGetVolumeName(
	cdHVolume			hVolume,
	cdVolName*			pVolName
);

cdCAPI CDGetVolumeInfo(
	cdHVolume			hVolume,
	cdVolumeInfo*		pVolInfo
);

cdCAPI CDEnumItemReset(
	cdHItem				hParent,
	cdEnumItemOption	Option,
	cdHEnum*			phEnum
);

cdCAPI CDEnumItemNext(
	cdHEnum				hEnum,
	cdHItem*			phItem
);

cdCAPI CDGetItemCount (
	cdHEnum				hEnum,
	cdUInt32*			pCount
);

cdCAPI CDEnumItemRelease (
	cdHEnum				hEnum
);

cdCAPI CDEnumImageItemReset(
	cdHItem				hItem,
	cdUInt32			Depth,
	cdEnumItemOption	Option,
	cdHEnum*			phEnum
);

cdCAPI CDEnumImageItemNext( 
	cdHEnum				hEnum,
	cdHImageItem*		phImage
);

cdCAPI CDGetImageItemCount(
	cdHEnum				hEnum,
	cdUInt32*			pCount
);

cdCAPI CDEnumImageItemRelease (
	cdHEnum				hEnum
);

cdCAPI CDGetItemInfo(
	cdHItem				hItem,
	cdItemInfo*			pItemInfo
);

cdCAPI CDMakeImageItem(
	cdStgMedium			StgMedium,
	cdImageFormat		Format,
	cdHImageItem*		phImgItem
);

cdCAPI CDFreeImageItem(
	cdHImageItem		hImgItem
);

/*-----------------------------------------------------------------------
   Image Management Functions  
------------------------------------------------------------------------*/

cdCAPI CDOpenImage(
	cdHImageItem		hImgItem
);

cdCAPI CDCloseImage(
	cdHImageItem		hImgItem
);

cdCAPI CDGetThumbnail(
	cdHImageItem		hImgItem,
	cdHImageData*		phImgData
);

cdCAPI CDGetPicture(
	cdHImageItem		hImgItem,
	cdHImageData*		phImgData
);

cdCAPI CDGetMovie (
	cdHImageItem		hImgItem,
	cdHImageData*		phImgData
);

cdCAPI CDGetSound (
	cdHImageItem		hImgItem,
	cdHImageData*		phImgData
);

cdCAPI CDEnumImageDataInItemReset(
	cdHImageItem		hImgItem,
	cdHEnum*			phEnum
);

cdCAPI CDEnumImageDataInItemNext(
	cdHEnum				hEnum,
	cdHImageData*		phImgData
);

cdCAPI CDGetImageDataInItemCount(
	cdHEnum				hEnum,
	cdUInt32*			pCount
);

cdCAPI CDEnumImageDataInItemRelease (
	cdHEnum				hEnum
);

cdCAPI CDGetImageDataInfo(
	cdHImageData		hImgData,
	cdImageDataInfo*	pImgDataInfo
);

cdCAPI CDGetImageData(
	cdHImageData 				hImgData,
	cdStgMedium*				pStgMediumDest,
	cdProgressCallbackFunction*	pCallbackFunc,
	cdContext					Context,
	cdProgressOption			ProgressOption
);

cdCAPI CDAddPicture(
	cdStgMedium*				pSrc, 
	cdImageFormatStruct*		pSrcFileFormat,
	cdHVolume					hVolume,
	cdHFolder					hFolder,
	cdCompQuality				CompQuality,
	cdChar*						pModelName,
	cdAddPictureFlags			OptionFlags,
	cdAddPictureProps*			pAddImageProps,	
	cdProgressCallbackFunction*	pCallbackFunc,
	cdContext					Context,
	cdProgressOption			ProgressOption,
	cdAddPictureInfo*			pAddInfo
);

cdCAPI CDDeleteImage(
	cdHItem				hParent,
	cdHImageItem 		hImgItem
);


/*-----------------------------------------------------------------------
   Markfile Functions     
------------------------------------------------------------------------*/

cdCAPI CDIsPrintMarked( 
	cdHImageItem		hImgItem,
	cdBoolean*  		pbMarked
);

cdCAPI CDIsSlideMarked( 
	cdHImageItem		hImgItem,
	cdBoolean*  		pbMarked
);

cdCAPI CDIsTransferMarked( 
	cdHImageItem		hImgItem,
	cdBoolean*  		pbMarked
);


/*-----------------------------------------------------------------------
   Image Property Functions
------------------------------------------------------------------------*/

cdCAPI CDEnumBaseImageDataPropertyReset (
	cdHImageData			hImgData,
	cdHEnum*				phEnum
);

cdCAPI CDEnumBaseImageDataPropertyNext(
	cdHEnum					hEnum,
	cdBaseImagePropertyStruct*	pBaseImgPropStruct
);

cdCAPI CDGetBaseImageDataPropertyCount (
	cdHEnum					hEnum,
	cdUInt32*				pCount		
);

cdCAPI CDEnumBaseImageDataPropertyRelease (
	cdHEnum					hEnum
);

cdCAPI CDGetBaseImageDataProperty (
	cdHImageData			hImgData,
	cdBaseImagePropertyID 	BaseImgPropID,
	cdUInt32*				pBufSize,
	cdVoid*					pBuf
);

cdCAPI CDEnumImageItemPropertyReset (
	cdHImageItem			hImgItem,
	cdHEnum*				phEnum
);

cdCAPI CDEnumImageItemPropertyNext (
	cdHEnum					hEnum,
	cdImagePropertyStruct*	pImgPropStruct
);

cdCAPI CDGetImageItemPropertyCount (
	cdHEnum					hEnum,
	cdUInt32*				pCount		
);

cdCAPI CDEnumImageItemPropertyRelease (
	cdHEnum					hEnum
);

cdCAPI CDGetImageItemProperty(
	cdHImageItem			hImgItem,
	cdImagePropertyID 		ImgPropID,
	cdUInt32*				pBufSize,
	cdVoid*					pBuf
);

cdCAPI CDSetImageItemProperty(
	cdHImageItem			hImgItem,
	cdImagePropertyID 		ImgPropID,
	cdUInt32*				pBufSize,
	cdVoid*					pBuf
);

cdCAPI CDFlashImageItemProperty(
	cdHImageItem			hImgItem
);

cdCAPI CDGetThumbnailValidArea(
	cdHImageItem			hImgItem,
	cdRect*					pFrame
);