| Platform SDK: Removable Storage Manager |
This section includes Removable Storage Manager (RSM) functions.
Note These functions were defined before NTMS was renamed to Removable Storage Manager and as a result each function name contains the prefix "Ntms". Similarly, the "scratch" pool was renamed "free", and the "foreign" pool was renamed "unrecognized". The term "partition" was replaced with the term "side".
RSM can automatically clean tape drives that become dirty through use. Use the following functions to control drive cleaning:
RSM uses a database to store information about the removable media devices and cartridges in a system. Like any system resource, this database should be backed up in case it becomes lost or corrupted. Use the following functions for RSM database backup and recovery:
You can use the following functions to get notifications when RSM database objects change:
Before calling any other functions, an application must open an RSM session, and the session must be closed before the application exits. The following session management functions open and close RSM sessions:
Library control functions control:
You can use the following library control functions:
Media services functions are used for:
You can use the following media services functions:
You can use the following functions to enumerate, get, and set information about RSM objects:
RSM identifies media in a system by reading an on-media identifier (OMID) The following function updates the RSM database when a new OMID is written:
You can use the following functions to manage and control requests to system operators:
RSM does not detect inject and eject operations on standalone drives unless requested to do so by the application. Although some RSM functions automatically begin change detection of certain devices, applications that require current information on the presence or absence of media in standalone drives must use these functions to request RSM to detect the changes. With change detection enabled, an application can use database notification functions to be notified when media is injected and ejected. You can use the following functions: