Interfaz IMDSPEnumStorage (mswmdm.h)

Artículo
08/25/2023

La interfaz IMDSPEnumStorage se usa para enumerar los medios de almacenamiento en un dispositivo. Para obtener más información sobre la implementación estándar de interfaces de enumeración, consulte la documentación de Microsoft COM, disponible en el sitio web de Microsoft. Los medios de almacenamiento de un dispositivo se organizan de forma jerárquica similar a las unidades de disco de un equipo.

Cuando se accede desde el método IMDSPDevice::EnumStorage , esta interfaz enumera los medios de almacenamiento individuales en el dispositivo de la misma manera que vería las unidades de disco individuales en un equipo.

Cuando se accede desde el método IWMDMStorage::EnumStorage , esta interfaz enumera el contenido del medio de almacenamiento. Se puede llamar a EnumStorage en los objetos de almacenamiento enumerados de forma recursiva y, por tanto, el contenido de un medio de almacenamiento se devuelve de la manera jerárquica en la que se almacenan en el medio de almacenamiento. Si el sistema de archivos del medio de almacenamiento admite una noción de orden entre el contenido, el enumerador devolverá el contenido en el mismo orden.

El enumerador de almacenamiento devuelve una instantánea del estado de los almacenamientos. Puede que no refleje el efecto de la inserción y eliminación de medios de almacenamiento y que no refleje los efectos de los métodos Insert, Move y Delete posteriores. El cliente debe obtener un nuevo enumerador para obtener el nuevo estado del medio de almacenamiento.

Los métodos Insert, Move y Delete de la interfaz IWMDMStorageControl cambian el orden de los archivos. Si se invocan estas operaciones, se puede cambiar el orden de los objetos devueltos originalmente por la interfaz IMDSPEnumStorage .

Si una aplicación va a mostrar el orden de contenido en un dispositivo multimedia, el programador de aplicaciones debe tener en cuenta los cambios de orden que se pueden producir como resultado de las operaciones IWMDMStorageControl . Hay dos maneras de tratar esta situación. Una manera es volver a enumerar simplemente cada vez que se produce un cambio en el contenido. Otra manera es mantener el orden de los objetos IWMDMStorage mediante programación.

Independientemente de cómo se controle este problema, la aplicación debe controlarlo si el orden de los archivos es importante para la aplicación.

Herencia

La interfaz IMDSPEnumStorage hereda de la interfaz IUnknown . IMDSPEnumStorage también tiene estos tipos de miembros:

Métodos

La interfaz IMDSPEnumStorage tiene estos métodos.


IMDSPEnumStorage::Clone El método Clone crea otro enumerador que contiene el mismo estado de enumeración que el actual. (IMDSPEnumStorage.Clone)
IMDSPEnumStorage::Next El método Next devuelve un puntero a las siguientes interfaces celtIMDSPStorage.
IMDSPEnumStorage::Reset El método Reset restablece la secuencia de enumeración al principio. Una llamada posterior al método Next captura la primera interfaz de almacenamiento de la secuencia de enumeración.
IMDSPEnumStorage::Skip El método Skip omite el siguiente número especificado de interfaces de almacenamiento en la secuencia de enumeración.