IWMPSyncDevice::getItemInfo method (wmp.h)
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The getItemInfo method retrieves a metadata value from the device.
Syntax
HRESULT getItemInfo(
[in] BSTR bstrItemName,
[out] BSTR *pbstrVal
);
Parameters
[in] bstrItemName
BSTR containing the metadata item name. The following table lists the supported item names and describes the value that each retrieves.
Name | Retrieves |
---|---|
AutoSyncDefaultRules |
Whether automatic synchronization is done according to default rules or custom rules. A value of "True" indicates default rules, and a value of "False" indicates custom rules.
Use of this attribute is permitted only for devices that have a partnership with Windows Media Player. Requires Windows Media Player 12. |
BackgroundSyncState |
Whether Windows Media Player is allowed to perform background operations for the device.
The value can be a string (BSTR) representation of a bitwise combination of one or more of the following flags.
Use of this attribute is permitted only for devices that have a partnership with Windows Media Player. Requires Windows Media Player 12. |
Connected | Whether the device is currently connected to Windows Media Player. Possible values are "True" and "False". |
FreeSpace | The size, in bytes, of the available device memory. |
FriendlyName | The friendly name for the device. |
LastSyncErrorCount | The number of synchronization errors that occurred during the most recent synchronization. |
LastSyncNoFitCount | The number of media items that would not fit on the device during the most recent synchronization. |
LastSyncTime | The time of the most recent synchronization. |
Name | The name of the device. |
PercentSpaceReserved | Limits the amount of device storage that Windows Media Player uses for file synchronization by specifying a portion of the storage as reserved. The value is the numeric percentage of total storage on the device represented by a string (BSTR). Supported values range from "0" to "95" inclusive.Use of this attribute is permitted only for devices that have a partnership with Windows Media Player.
Requires Windows Media Player 11. |
PreferredAudio |
A string (BSTR) representation of the numeric identifier of the preferred storage for audio files on the device. If the device supports hints, the preferred storage is the location specified by the hint. If the device does not support hints, the preferred storage is the largest storage.
Requires Windows Media Player 12. |
PreferredVideo |
A string (BSTR) representation of the numeric identifier of the preferred storage for video files on the device. If the device supports hints, the preferred storage is the location specified by the hint. If the device does not support hints, the preferred storage is the largest storage.
Requires Windows Media Player 12. |
PreferredPhoto |
A string (BSTR) representation of the numeric identifier of the preferred storage for picture files on the device. If the device supports hints, the preferred storage is the location specified by the hint. If the device does not support hints, the preferred storage is the largest storage.
Requires Windows Media Player 12. |
SerialNumber | The device serial number. |
SkippedFiles |
Whether the device has any skipped files. A value of "1" indicates that the device has skipped files. A value of "0" indicates that the device does not have any skipped files.
Use of this attribute is permitted only for devices with which Windows Media Player has a partnership. Requires Windows Media Player 12. |
SupportsAudio | Whether the device supports audio playback. Possible values are "True" and "False". |
SupportsPhoto | Whether the device supports displaying photos. Possible values are "True" and "False". |
SupportsVideo | Whether the device supports video playback. Possible values are "True" and "False". |
SyncFilter |
The types of files that will be synchronized during the next synchronization session, and an indication of whether content can be acquired from the device during that synchronization session.
The value can be a string (BSTR) representation of a bitwise combination of one or more of the following flags.
The value can also be one of the following strings.
Use of this attribute is permitted only for devices that have a partnership with Windows Media Player. Requires Windows Media Player 12. |
SyncIndex | The partnership index for the device. Possible values are the integers 0 through 16. |
SyncItemCount | The count of items synchronized to the device. |
SyncOnConnect |
Whether Windows Media Player will synchronize the device when the device gets connected. A value of "True" indicates that Windows Media Player will synchronize the device, and a value of "False" indicates that Windows Media Player will not synchronize the device.
Use of this attribute is permitted only for devices that have a partnership with Windows Media Player. Requires Windows Media Player 12. |
SyncPercentComplete | The progress of synchronization as a percentage. |
SyncRelationship | A number indicating how the device synchronizes with respect to the current instance of Windows Media Player. Possible values are:0, meaning no relationship.
1, meaning manual synchronization. 2, meaning a partnership exists with the current instance of Windows Media Player. 3, meaning a partnership exists with another instance of Windows Media Player. |
TotalSpace | The size, in bytes, of the total memory for the device. |
[out] pbstrVal
Pointer to a BSTR that contains the specified metadata item name.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
Return code | Description |
---|---|
|
The method succeeded. |
|
Windows Media Player is currently busy initializing devices. Please try again later. |
Remarks
This method cannot retrieve metadata values for devices having the status wmpdsManualDevice.
Windows Media Player 10 Mobile: This method is not supported.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Media Player 10 or later |
Target Platform | Windows |
Header | wmp.h |
DLL | Wmp.dll |