IMDSPDevice Interface
.gif "banner art") |
The IMDSPDevice interface provides an instance-based association with a media device. Using this interface, the client can get a storage media enumerator for the device, get information about the device, and send opaque (pass-through) commands to the device. IMDServiceProvider2 extends IMDSPDevice by providing methods for getting video formats, getting Plug and Play (PnP) device names, enabling the use of property pages, and making it possible to get a pointer to a storage medium from its name. This interface is optional for the service provider but is recommended.
In addition to the methods inherited from IUnknown, the IMDSPDevice interface exposes the following methods.
| Method | Description |
| EnumStorage | Enumerates the top-level storage medium on the device. This method is mandatory. |
| GetDeviceIcon | Retrieves a HICON value that represents the icon that the device service provider indicates must be used to represent this device. |
| GetFormatSupport | Enumerates the formats supported by the device. This method is mandatory. |
| GetManufacturer | Retrieves the name of the manufacturer of the device. |
| GetName | Retrieves the name of the device. |
| GetPowerSource | Reports whether the device is capable of running on batteries, external power, or both, and on which type of power source it is currently running. |
| GetSerialNumber | Retrieves the serial number that uniquely identifies the device. This method is mandatory. |
| GetStatus | Retrieves the device status information. This method is mandatory. |
| GetType | Retrieves device type information. This method is mandatory. |
| GetVersion | Retrieves the version number of the device. |
| SendOpaqueCommand | Sends a command to a device through Windows Media Device Manager. Windows Media Device Manager transmits the command without acting on it. |
See Also