Windows Media Format SDK banner art
PreviousNext

IMDSPEnumStorage Interface

The IMDSPEnumStorage interface is used to enumerate the storage media on a device. For more information on the standard implementation of enumeration interfaces, see the Microsoft COM documentation, available at http://www.microsoft.com/com/. The storage media on a device are organized in a hierarchical manner similar to disk drives on a computer.

When accessed from the IMDSPDevice::EnumStorage method, this interface enumerates the individual storage media on the device in the same way that you would see the individual disk drives on a computer.

When accessed from the IWMDMStorage::EnumStorage method, this interface enumerates the contents of the storage medium. The contents are returned in the order in which they are stored on the medium, if the device can supply that information.

The Insert, Move, and Delete methods of the IWMDMStorageControl interface change the order of files. If these operations are invoked, then the order of objects as originally returned by the IMDSPEnumStorage interface can be changed.

If an application is going to display the order of content on a media device, the application programmer must take into account order changes that can occur as a result of IWMDMStorageControl operations. There are two ways to deal with this situation. One way is to simply re-enumerate whenever a change to content occurs. Another way is to maintain the order of IWMDMStorage objects programmatically.

No matter how this issue is handled, it must be handled by the application if the order of files is important to the application.

In addition to the methods inherited from IUnknown, the IMDSPEnumStorage interface exposes the following methods.

Method Description
Clone Creates another enumerator that contains the same enumeration state as the current one.
Next Retrieves a pointer to the next IMDSPStorage interface.
Reset Resets the enumeration sequence to the beginning.
Skip Skips over the next specified number of storage interface(s) in the enumeration sequence.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.