Updating Portable Devices

[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.]

Windows Media Player enables users to synchronize digital media content with portable devices. This can include music content purchased or rented from an online store. Under some circumstances, online store providers might want to write code to work on a connected portable device as part of managing content provided by the store. To give the online store plug-in the opportunity to work with a connected device, Windows Media Player calls IWMPContentPartner::UpdateDevice and provides the canonical name of the portable device. If the plug-in code determines that some work must be done with the connected device, it must immediately return S_OK from the call to UpdateDevice before proceeding to do the work. If there is no work to do, the plug-in should return an error code.

When the plug-in has finished using the device, it must call IWMPContentPartnerCallback::UpdateDeviceComplete to notify Windows Media Player that the device is available.

Programming Guide for Type 1 Online Stores