Edit

Enumerating devices (WMDM)

  • Article

Windows Media Device Manager maintains a cache of connected devices that is updated when a Windows Media Device Manager application starts, when a Plug and Play (PnP) device connects or disconnects, or when the application calls IWMDeviceManager2::Reinitialize. This cache is exposed to the application when it calls IWMDeviceManager::EnumDevices or IWMDeviceManager2::EnumDevices2. Each device is exposed to the application as an IWMDMDevice interface. If the service provider is registered to handle PnP devices, Windows Media Device Manager will be aware of the current list of connected devices. If the service provider is registered to handle non-PnP devices, the service provider is responsible for discovering attached devices. A service provider can only be registered for PnP or non-PnP devices, never both.

The following actions show how Windows Media Device Manager maintains or updates its cache. Notice that the cache is never updated when a non-PnP device connects or disconnects.

A Windows Media Device Manager application starts

  • Windows Media Device Manager retrieves a list of attached PnP devices from the PnP subsystem, and calls IMDServiceProvider2::CreateDevice on the SP registered for each connected device. (It discovers the correct service provider by querying the WMDMSPCLSID device parameter for the class ID of the service provider responsible for this device. See Device Parameters for more information.) All devices returned are added to the Windows Media Device Manager cache of devices.
  • Windows Media Device Manager finds all non-PnP service providers registered with it and calls IMDServiceProvider::EnumDevices on each service provider to get a list devices from each one. All devices returned are added to the cache.

The application calls IWMDeviceManager/2::EnumDevices/2

  • Windows Media Device Manager returns its cached device list.

A PnP device connects

  • Windows Media Device Manager finds the relevant service provider and calls IMDServiceProvider2::CreateDevice, and adds the device to its cache.
  • If the application implements IWMDMNotification, Windows Media Device Manager calls IWMDMNotification::WMDMMessage with an arrival notification.

A PnP device disconnects

  • Windows Media Device Manager removes the item from its cache.
  • If the application implements IWMDMNotification, Windows Media Device Manager calls IWMDMNotification::WMDMMessage with a departure notification.

The application calls IWMDeviceManager2::Reinitialize

  • Refreshes the cache with all connected devices.

A non-PnP device connects or disconnects

  • Windows Media Device Manager is not informed of the arrival or departure, and takes no action.

Creating a Service Provider