29 #ifndef LIBMTP_H_INCLUSION_GUARD
30 #define LIBMTP_H_INCLUSION_GUARD
32 #define LIBMTP_VERSION 1.1.18
33 #define LIBMTP_VERSION_STRING "1.1.18"
40 #define snprintf _snprintf
42 #define ssize_t SSIZE_T
49 typedef unsigned char uint8_t;
50 typedef __int16 int16_t;
51 typedef unsigned __int16 uint16_t;
52 typedef __int32 int32_t;
53 typedef unsigned __int32 uint32_t;
54 typedef unsigned __int64 uint64_t;
75 #define LIBMTP_DEBUG_NONE 0x00
76 #define LIBMTP_DEBUG_PTP 0x01
77 #define LIBMTP_DEBUG_PLST 0x02
78 #define LIBMTP_DEBUG_USB 0x04
79 #define LIBMTP_DEBUG_DATA 0x08
80 #define LIBMTP_DEBUG_ALL 0xFF
89 LIBMTP_FILETYPE_FOLDER,
94 LIBMTP_FILETYPE_AUDIBLE,
96 LIBMTP_FILETYPE_UNDEF_AUDIO,
102 LIBMTP_FILETYPE_UNDEF_VIDEO,
103 LIBMTP_FILETYPE_JPEG,
104 LIBMTP_FILETYPE_JFIF,
105 LIBMTP_FILETYPE_TIFF,
108 LIBMTP_FILETYPE_PICT,
110 LIBMTP_FILETYPE_VCALENDAR1,
111 LIBMTP_FILETYPE_VCALENDAR2,
112 LIBMTP_FILETYPE_VCARD2,
113 LIBMTP_FILETYPE_VCARD3,
114 LIBMTP_FILETYPE_WINDOWSIMAGEFORMAT,
115 LIBMTP_FILETYPE_WINEXEC,
116 LIBMTP_FILETYPE_TEXT,
117 LIBMTP_FILETYPE_HTML,
118 LIBMTP_FILETYPE_FIRMWARE,
120 LIBMTP_FILETYPE_MEDIACARD,
121 LIBMTP_FILETYPE_FLAC,
131 LIBMTP_FILETYPE_ALBUM,
132 LIBMTP_FILETYPE_PLAYLIST,
133 LIBMTP_FILETYPE_UNKNOWN
143 #define LIBMTP_FILETYPE_IS_AUDIO(a)\
144 (a == LIBMTP_FILETYPE_WAV ||\
145 a == LIBMTP_FILETYPE_MP3 ||\
146 a == LIBMTP_FILETYPE_MP2 ||\
147 a == LIBMTP_FILETYPE_WMA ||\
148 a == LIBMTP_FILETYPE_OGG ||\
149 a == LIBMTP_FILETYPE_FLAC ||\
150 a == LIBMTP_FILETYPE_AAC ||\
151 a == LIBMTP_FILETYPE_M4A ||\
152 a == LIBMTP_FILETYPE_AUDIBLE ||\
153 a == LIBMTP_FILETYPE_UNDEF_AUDIO)
162 #define LIBMTP_FILETYPE_IS_VIDEO(a)\
163 (a == LIBMTP_FILETYPE_WMV ||\
164 a == LIBMTP_FILETYPE_AVI ||\
165 a == LIBMTP_FILETYPE_MPEG ||\
166 a == LIBMTP_FILETYPE_UNDEF_VIDEO)
172 #define LIBMTP_FILETYPE_IS_AUDIOVIDEO(a)\
173 (a == LIBMTP_FILETYPE_MP4 ||\
174 a == LIBMTP_FILETYPE_ASF ||\
175 a == LIBMTP_FILETYPE_QT)
183 #define LIBMTP_FILETYPE_IS_TRACK(a)\
184 (LIBMTP_FILETYPE_IS_AUDIO(a) ||\
185 LIBMTP_FILETYPE_IS_VIDEO(a) ||\
186 LIBMTP_FILETYPE_IS_AUDIOVIDEO(a))
192 #define LIBMTP_FILETYPE_IS_IMAGE(a)\
193 (a == LIBMTP_FILETYPE_JPEG ||\
194 a == LIBMTP_FILETYPE_JFIF ||\
195 a == LIBMTP_FILETYPE_TIFF ||\
196 a == LIBMTP_FILETYPE_BMP ||\
197 a == LIBMTP_FILETYPE_GIF ||\
198 a == LIBMTP_FILETYPE_PICT ||\
199 a == LIBMTP_FILETYPE_PNG ||\
200 a == LIBMTP_FILETYPE_JP2 ||\
201 a == LIBMTP_FILETYPE_JPX ||\
202 a == LIBMTP_FILETYPE_WINDOWSIMAGEFORMAT)
208 #define LIBMTP_FILETYPE_IS_ADDRESSBOOK(a)\
209 (a == LIBMTP_FILETYPE_VCARD2 ||\
210 a == LIBMTP_FILETYPE_VCARD3)
216 #define LIBMTP_FILETYPE_IS_CALENDAR(a)\
217 (a == LIBMTP_FILETYPE_VCALENDAR1 ||\
218 a == LIBMTP_FILETYPE_VCALENDAR2)
225 LIBMTP_PROPERTY_StorageID,
226 LIBMTP_PROPERTY_ObjectFormat,
227 LIBMTP_PROPERTY_ProtectionStatus,
228 LIBMTP_PROPERTY_ObjectSize,
229 LIBMTP_PROPERTY_AssociationType,
230 LIBMTP_PROPERTY_AssociationDesc,
231 LIBMTP_PROPERTY_ObjectFileName,
232 LIBMTP_PROPERTY_DateCreated,
233 LIBMTP_PROPERTY_DateModified,
234 LIBMTP_PROPERTY_Keywords,
235 LIBMTP_PROPERTY_ParentObject,
236 LIBMTP_PROPERTY_AllowedFolderContents,
237 LIBMTP_PROPERTY_Hidden,
238 LIBMTP_PROPERTY_SystemObject,
239 LIBMTP_PROPERTY_PersistantUniqueObjectIdentifier,
240 LIBMTP_PROPERTY_SyncID,
241 LIBMTP_PROPERTY_PropertyBag,
242 LIBMTP_PROPERTY_Name,
243 LIBMTP_PROPERTY_CreatedBy,
244 LIBMTP_PROPERTY_Artist,
245 LIBMTP_PROPERTY_DateAuthored,
246 LIBMTP_PROPERTY_Description,
247 LIBMTP_PROPERTY_URLReference,
248 LIBMTP_PROPERTY_LanguageLocale,
249 LIBMTP_PROPERTY_CopyrightInformation,
250 LIBMTP_PROPERTY_Source,
251 LIBMTP_PROPERTY_OriginLocation,
252 LIBMTP_PROPERTY_DateAdded,
253 LIBMTP_PROPERTY_NonConsumable,
254 LIBMTP_PROPERTY_CorruptOrUnplayable,
255 LIBMTP_PROPERTY_ProducerSerialNumber,
256 LIBMTP_PROPERTY_RepresentativeSampleFormat,
257 LIBMTP_PROPERTY_RepresentativeSampleSize,
258 LIBMTP_PROPERTY_RepresentativeSampleHeight,
259 LIBMTP_PROPERTY_RepresentativeSampleWidth,
260 LIBMTP_PROPERTY_RepresentativeSampleDuration,
261 LIBMTP_PROPERTY_RepresentativeSampleData,
262 LIBMTP_PROPERTY_Width,
263 LIBMTP_PROPERTY_Height,
264 LIBMTP_PROPERTY_Duration,
265 LIBMTP_PROPERTY_Rating,
266 LIBMTP_PROPERTY_Track,
267 LIBMTP_PROPERTY_Genre,
268 LIBMTP_PROPERTY_Credits,
269 LIBMTP_PROPERTY_Lyrics,
270 LIBMTP_PROPERTY_SubscriptionContentID,
271 LIBMTP_PROPERTY_ProducedBy,
272 LIBMTP_PROPERTY_UseCount,
273 LIBMTP_PROPERTY_SkipCount,
274 LIBMTP_PROPERTY_LastAccessed,
275 LIBMTP_PROPERTY_ParentalRating,
276 LIBMTP_PROPERTY_MetaGenre,
277 LIBMTP_PROPERTY_Composer,
278 LIBMTP_PROPERTY_EffectiveRating,
279 LIBMTP_PROPERTY_Subtitle,
280 LIBMTP_PROPERTY_OriginalReleaseDate,
281 LIBMTP_PROPERTY_AlbumName,
282 LIBMTP_PROPERTY_AlbumArtist,
283 LIBMTP_PROPERTY_Mood,
284 LIBMTP_PROPERTY_DRMStatus,
285 LIBMTP_PROPERTY_SubDescription,
286 LIBMTP_PROPERTY_IsCropped,
287 LIBMTP_PROPERTY_IsColorCorrected,
288 LIBMTP_PROPERTY_ImageBitDepth,
289 LIBMTP_PROPERTY_Fnumber,
290 LIBMTP_PROPERTY_ExposureTime,
291 LIBMTP_PROPERTY_ExposureIndex,
292 LIBMTP_PROPERTY_DisplayName,
293 LIBMTP_PROPERTY_BodyText,
294 LIBMTP_PROPERTY_Subject,
295 LIBMTP_PROPERTY_Priority,
296 LIBMTP_PROPERTY_GivenName,
297 LIBMTP_PROPERTY_MiddleNames,
298 LIBMTP_PROPERTY_FamilyName,
299 LIBMTP_PROPERTY_Prefix,
300 LIBMTP_PROPERTY_Suffix,
301 LIBMTP_PROPERTY_PhoneticGivenName,
302 LIBMTP_PROPERTY_PhoneticFamilyName,
303 LIBMTP_PROPERTY_EmailPrimary,
304 LIBMTP_PROPERTY_EmailPersonal1,
305 LIBMTP_PROPERTY_EmailPersonal2,
306 LIBMTP_PROPERTY_EmailBusiness1,
307 LIBMTP_PROPERTY_EmailBusiness2,
308 LIBMTP_PROPERTY_EmailOthers,
309 LIBMTP_PROPERTY_PhoneNumberPrimary,
310 LIBMTP_PROPERTY_PhoneNumberPersonal,
311 LIBMTP_PROPERTY_PhoneNumberPersonal2,
312 LIBMTP_PROPERTY_PhoneNumberBusiness,
313 LIBMTP_PROPERTY_PhoneNumberBusiness2,
314 LIBMTP_PROPERTY_PhoneNumberMobile,
315 LIBMTP_PROPERTY_PhoneNumberMobile2,
316 LIBMTP_PROPERTY_FaxNumberPrimary,
317 LIBMTP_PROPERTY_FaxNumberPersonal,
318 LIBMTP_PROPERTY_FaxNumberBusiness,
319 LIBMTP_PROPERTY_PagerNumber,
320 LIBMTP_PROPERTY_PhoneNumberOthers,
321 LIBMTP_PROPERTY_PrimaryWebAddress,
322 LIBMTP_PROPERTY_PersonalWebAddress,
323 LIBMTP_PROPERTY_BusinessWebAddress,
324 LIBMTP_PROPERTY_InstantMessengerAddress,
325 LIBMTP_PROPERTY_InstantMessengerAddress2,
326 LIBMTP_PROPERTY_InstantMessengerAddress3,
327 LIBMTP_PROPERTY_PostalAddressPersonalFull,
328 LIBMTP_PROPERTY_PostalAddressPersonalFullLine1,
329 LIBMTP_PROPERTY_PostalAddressPersonalFullLine2,
330 LIBMTP_PROPERTY_PostalAddressPersonalFullCity,
331 LIBMTP_PROPERTY_PostalAddressPersonalFullRegion,
332 LIBMTP_PROPERTY_PostalAddressPersonalFullPostalCode,
333 LIBMTP_PROPERTY_PostalAddressPersonalFullCountry,
334 LIBMTP_PROPERTY_PostalAddressBusinessFull,
335 LIBMTP_PROPERTY_PostalAddressBusinessLine1,
336 LIBMTP_PROPERTY_PostalAddressBusinessLine2,
337 LIBMTP_PROPERTY_PostalAddressBusinessCity,
338 LIBMTP_PROPERTY_PostalAddressBusinessRegion,
339 LIBMTP_PROPERTY_PostalAddressBusinessPostalCode,
340 LIBMTP_PROPERTY_PostalAddressBusinessCountry,
341 LIBMTP_PROPERTY_PostalAddressOtherFull,
342 LIBMTP_PROPERTY_PostalAddressOtherLine1,
343 LIBMTP_PROPERTY_PostalAddressOtherLine2,
344 LIBMTP_PROPERTY_PostalAddressOtherCity,
345 LIBMTP_PROPERTY_PostalAddressOtherRegion,
346 LIBMTP_PROPERTY_PostalAddressOtherPostalCode,
347 LIBMTP_PROPERTY_PostalAddressOtherCountry,
348 LIBMTP_PROPERTY_OrganizationName,
349 LIBMTP_PROPERTY_PhoneticOrganizationName,
350 LIBMTP_PROPERTY_Role,
351 LIBMTP_PROPERTY_Birthdate,
352 LIBMTP_PROPERTY_MessageTo,
353 LIBMTP_PROPERTY_MessageCC,
354 LIBMTP_PROPERTY_MessageBCC,
355 LIBMTP_PROPERTY_MessageRead,
356 LIBMTP_PROPERTY_MessageReceivedTime,
357 LIBMTP_PROPERTY_MessageSender,
358 LIBMTP_PROPERTY_ActivityBeginTime,
359 LIBMTP_PROPERTY_ActivityEndTime,
360 LIBMTP_PROPERTY_ActivityLocation,
361 LIBMTP_PROPERTY_ActivityRequiredAttendees,
362 LIBMTP_PROPERTY_ActivityOptionalAttendees,
363 LIBMTP_PROPERTY_ActivityResources,
364 LIBMTP_PROPERTY_ActivityAccepted,
365 LIBMTP_PROPERTY_Owner,
366 LIBMTP_PROPERTY_Editor,
367 LIBMTP_PROPERTY_Webmaster,
368 LIBMTP_PROPERTY_URLSource,
369 LIBMTP_PROPERTY_URLDestination,
370 LIBMTP_PROPERTY_TimeBookmark,
371 LIBMTP_PROPERTY_ObjectBookmark,
372 LIBMTP_PROPERTY_ByteBookmark,
373 LIBMTP_PROPERTY_LastBuildDate,
374 LIBMTP_PROPERTY_TimetoLive,
375 LIBMTP_PROPERTY_MediaGUID,
376 LIBMTP_PROPERTY_TotalBitRate,
377 LIBMTP_PROPERTY_BitRateType,
378 LIBMTP_PROPERTY_SampleRate,
379 LIBMTP_PROPERTY_NumberOfChannels,
380 LIBMTP_PROPERTY_AudioBitDepth,
381 LIBMTP_PROPERTY_ScanDepth,
382 LIBMTP_PROPERTY_AudioWAVECodec,
383 LIBMTP_PROPERTY_AudioBitRate,
384 LIBMTP_PROPERTY_VideoFourCCCodec,
385 LIBMTP_PROPERTY_VideoBitRate,
386 LIBMTP_PROPERTY_FramesPerThousandSeconds,
387 LIBMTP_PROPERTY_KeyFrameDistance,
388 LIBMTP_PROPERTY_BufferSize,
389 LIBMTP_PROPERTY_EncodingQuality,
390 LIBMTP_PROPERTY_EncodingProfile,
391 LIBMTP_PROPERTY_BuyFlag,
392 LIBMTP_PROPERTY_UNKNOWN
399 LIBMTP_DATATYPE_INT8,
400 LIBMTP_DATATYPE_UINT8,
401 LIBMTP_DATATYPE_INT16,
402 LIBMTP_DATATYPE_UINT16,
403 LIBMTP_DATATYPE_INT32,
404 LIBMTP_DATATYPE_UINT32,
405 LIBMTP_DATATYPE_INT64,
406 LIBMTP_DATATYPE_UINT64,
449 LIBMTP_ERROR_GENERAL,
450 LIBMTP_ERROR_PTP_LAYER,
451 LIBMTP_ERROR_USB_LAYER,
452 LIBMTP_ERROR_MEMORY_ALLOCATION,
453 LIBMTP_ERROR_NO_DEVICE_ATTACHED,
454 LIBMTP_ERROR_STORAGE_FULL,
455 LIBMTP_ERROR_CONNECTING,
456 LIBMTP_ERROR_CANCELLED
485 void const *
const data);
500 uint32_t wantlen,
unsigned char *data, uint32_t *gotlen);
515 uint32_t sendlen,
unsigned char *data, uint32_t *putlen);
520 #define LIBMTP_HANDLER_RETURN_OK 0
521 #define LIBMTP_HANDLER_RETURN_ERROR 1
522 #define LIBMTP_HANDLER_RETURN_CANCEL 2
811 LIBMTP_EVENT_STORE_ADDED,
812 LIBMTP_EVENT_STORE_REMOVED,
813 LIBMTP_EVENT_OBJECT_ADDED,
814 LIBMTP_EVENT_OBJECT_REMOVED,
815 LIBMTP_EVENT_DEVICE_PROPERTY_CHANGED,
873 #define LIBMTP_STORAGE_SORTBY_NOTSORTED 0
874 #define LIBMTP_STORAGE_SORTBY_FREESPACE 1
875 #define LIBMTP_STORAGE_SORTBY_MAXSPACE 2
920 #define LIBMTP_FILES_AND_FOLDERS_ROOT 0xffffffff
967 unsigned char **data,
unsigned int *size);
1060 unsigned char **,
unsigned int *);
1062 uint64_t,
unsigned char *,
unsigned int);
1072 typedef void(* LIBMTP_event_cb_fn) (int, LIBMTP_event_t, uint32_t,
void *);