Windows Media Player 11 SDK WMP_WMDM_METADATA_ROUND_TRIP_DEVICE2PCÂ
Previous | Next |
WMP_WMDM_METADATA_ROUND_TRIP_DEVICE2PC
The WMP_WMDM_METADATA_ROUND_TRIP_DEVICE2PC structure is used by Windows Media Player to receive accelerated metadata synchronization information from portable devices that do not support MTP.
Syntax
Members
dwCurrentTransactionID
The current transaction ID for the device. Windows Media Player stores this value and uses it for future requests.
dwReturnedObjectCount
The number of object path names returned in the wsObjectPathnameList member.
dwUnretrievedObjectCount
The number of objects that were changed or deleted, but that are not part of this response. A value greater than zero signals Windows Media Player to make a further request.
dwDeletedObjectStartingOffset
The index of the first character of the first deleted object path name. If the path name list contains only deleted objects, specify zero. If the path name list contains no deleted objects, specify the index of the last null character in the path name list. Note that this value is the number of Unicode characters to skip in wsObjectPathnameList, not the number of bytes.
dwFlags
DWORD containing status information. Status is indicated in a bitwise fashion by using the following flags.
Flag | Value | Description |
WMP_MDRT_FLAGS_UNREPORTED_DELETED_ITEMS | 0x1 | Items were deleted before the first object path name being reported. This often indicates that the device was reformatted. |
WMP_MDRT_FLAGS_UNREPORTED_ADDED_ITEMS | 0x2 | Some additional items were added that were not returned in the list of PUOIDs. |
Bits 2 through 31 are reserved for future use. These bits should be set to zero.
wsObjectPathnameList
Contains a contiguous list of null terminated Unicode path name strings, terminated with an extra null character. The list must be created in the following manner:
First, path name strings for all objects that have been added to the device or have had a change for the PlayCount, UserRating, or BuyNow attributes.
Second, path name strings for all objects that have been deleted. The index of the first character of this part of the list is contained in the dwDeletedObjectStartingOffset member.
Remarks
The Windows Media Device Manager service provider should return as many object path names as will fit in the buffer size specified by the pnOutBufferSize parameter of the DeviceIoControl method. If the buffer is not large enough to contain the path name strings for all the changes, the device must set the dwUnretrievedObjectCount member to the appropriate (non-zero) value.
Requirements
Version: Windows Media Player 10 or later.
Header: Defined in wmpdevices.h.
See Also
Previous | Next |