Acerca de la supervisión de carpetas

  • Artículo

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Reproductor multimedia de Windows puede supervisar las carpetas que contienen archivos multimedia digitales y actualizar la biblioteca cuando se agregan o quitan archivos. Esta funcionalidad de supervisión de carpetas la proporciona la interfaz IWMPFolderMonitorServices .

Para usar los servicios de supervisión de carpetas, debe crear el objeto Player en un estado remoto. Para obtener más información sobre la comunicación remota, vea Comunicación remota del control Reproductor multimedia de Windows. Después de crear una instancia remota del reproductor, obtenga un puntero a la interfaz IWMPFolderMonitorServices llamando a QueryInterface en la interfaz IWMPPlayer .

Reproductor multimedia de Windows mantiene una lista de carpetas que se están supervisando. Para obtener una lista de carpetas supervisadas, use los métodos IWMPFolderMonitorServices::get_count e IWMPFolderMonitorServices::item . Para agregar carpetas a la lista o quitarlas de la lista, use los métodos IWMPFolderMonitorServices::add y remove , respectivamente.

Iniciar un examen

La supervisión de carpetas suele ser un proceso en segundo plano que no es necesario llamar explícitamente. Si desea examinar activamente una carpeta, llame a IWMPFolderMonitorServices::startScan. Puede detener un examen en curso con el método IWMPFolderMonitorServices::stopScan .

Recuperación del estado de supervisión de carpetas

IWMPFolderMonitorServices proporciona funcionalidad para recuperar el estado del proceso de supervisión de carpetas.

El examen de carpetas se realiza en dos pasos. En el primer paso, el Reproductor examina las carpetas denominadas en la lista de carpetas supervisadas una por una y crea una lista de archivos que se van a agregar a la biblioteca. En el segundo paso, pasa por la lista de archivos y agrega los archivos a la biblioteca, y también quita los elementos multimedia de la biblioteca cuyos archivos físicos correspondientes se han eliminado del sistema de archivos.

El evento FolderScanStateChange se usa para notificar al programa cada vez que el Reproductor cambia a un nuevo estado. También puede recuperar el estado actual llamando a get_scanState. Cuando se inicia el primer paso, el valor de estado actual es wmpfssScanning. Durante el segundo paso, el estado cambia a wmpfssUpdating. Una vez finalizado el proceso, el estado cambia a wmpfssStopped.

Mientras el Reproductor examina las carpetas supervisadas en el primer pase, llame a get_scannedFilesCount para comprobar cuántos archivos se han examinado. El método get_currentFolder le indicará qué carpeta se está examinando actualmente.

Después de que se inicie el segundo paso, llame a get_addedFilesCount para comprobar cuántos archivos se han agregado a la biblioteca. El método get_updateProgress le indicará el progreso del segundo pase, como un porcentaje de 0 a 100.

Acerca del modelo de objetos del reproductor

IWMPFolderMonitorServices (Interfaz)