Previous

Next

Function USBMTPGetFileProperty

USBMTPGetFileProperty retrieves a Property of a file or directory on an MTP device:

int USBMTPGetFileProperty(int          Dev, 
                          USBMTPHandle Handle, 
                          WORD         PropertyCode, 
                          void       * Property, 
                          UINT         Len);

Parameters

Dev

Index of the MTP device. This value should be in range 0 .. RTUSBMTPConfig.MaxDevices - 1.

Handle

Handle of the file or directory to query. This handle could have been retrieved through functions USBMTPFindFirstFile/USBMTPFindNextFile.

PropertyCode

The code value of the requested property.

Property

Pointer to a buffer to receive the property.

Len

Number of available bytes in the buffer pointed to by parameter Property.

return value

If the function succeeds, the number of bytes of the requested property is returned. Only if this value is <= parameter Len, the property is copied to *Property. On error, a negative error code is returned.

Details about all available MTP file object properties are listed in Appendix B of the USB Media Transfer Protocol Specification, Revision 1.1. For each property, the PropertyCode and data type is listed. Please note that the returned file property is always returned in little endian format.

Function FindFile of demo program MTPDemo show how this function is used.

Function USBMTPDeleteFile

Function USBMTPSetFileProperty