IMDSPObject Interface (deprecated)
.gif) |
This is preliminary documentation and subject to change.
This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.
The IMDSPObject interface manages the transfer of data to and from storage media.
The Open, Read, Write, and Close methods are valid only if the storage object is a file. The client would typically call Open, perform a number of Read or Write operations and then call Close. This allows for a buffered mode read/write of the storage medium. The service provider should be able to handle any other calls on the device or storage interfaces (for example, enumerating content or getting global information about the storage medium) while the read or write operation is in progress.
The service provider should also be able to handle simultaneous read or write operations on multiple files. If the underlying file-system does not support opening of multiple files at the same time, service provider should gracefully return an error.
The Delete, Rename, and Move methods are valid for both files and folders.
In addition to the methods inherited from IUnknown, the IMDSPObject interface exposes the following methods.
| Method | Description |
| Close | Closes a file on a storage medium of a media device. |
| Delete | Deletes an object from a storage medium on a media device. This object can be either a file or a folder. |
| Move | Moves an object on a media device. This object can be either a file or a folder. |
| Open | Opens the associated object and prepares it for other operations. This object must be a file. |
| Read | Reads data from the object at the current position. This object must be a file. |
| Rename | Renames the associated object. This object can be either a file or a folder. |
| Seek | Sets the current position within the object. This object must be a file. |
| Write | Writes data to the object at the current position within the object. This object must be a file. |
See Also