volume_mgmt.h File Reference
#include <fio/public/volume_mgmt_types.h>
#include <fio/public/iodimm_types.h>
Go to the source code of this file.
Function Documentation
Closes a drive handle for a Fusion-io drive.
- Precondition:
- fio_vol_mgmt_open_drive_handle should have been previously called to initialize the member data properly.
- Note:
- This API is currently only implemented on the Windows platform
- Parameters:
-
| drive_handle | Pointer to a fio_drive_handle_t that has been allocated and passed to fio_vol_mgmt_open_drive_handle. |
DllExport void fio_vol_mgmt_fini |
( |
void |
|
) |
|
Finalizes the volume management functions (exported functions are listed here). This must be done to clean up resources that were allocated/loaded by fio_vol_mgmt_init.
- Note:
- This API is currently only implemented on the Windows platform
Initializes the volume management functions (exported functions are listed here).
Opens a drive handle for a Fusion-io drive.
- Precondition:
- selector must either previously been opened with open_device_handle or must have the name or index mode set.
- Note:
- This API is currently only implemented on the Windows platform
- Parameters:
-
| selector | Device selector. See the header file (volume_mgmt_types.h) for more information on how to populate this struct. If the device was not previously opened via open_iodimm_handle, this function internally opens and closes the device. |
| drive_handle | Pointer to a pre-allocated drive handle where data will be stored. |
- Returns:
- On success, FIO_VOLMAN_SUCCESS; otherwise, failure. The drive_handle->volumes are populated if the drive is part of one or more volumes. In addition to other data, each volume will have one or more mount points if that volume has been mounted. After a successful return, the caller must call fio_vol_mgmt_close_drive_handle to free any resources held in the drive_handle.
Refreshes the volumes (and their data and mount points) held by drive_handle.
- Precondition:
- drive_handle must must have been successfully opened using fio_vol_mgmt_open_drive_handle.
- Note:
- This API is currently only implemented on the Windows platform
- Parameters:
-
| drive_handle | Pointer to a fio_drive_handle_t that has been allocated and passed to fio_vol_mgmt_open_drive_handle. Note that drive_handle may or may not contain existing volume information prior to this function's invocation. In either case, fio_vol_mgmt_refresh_volumes takes care of freeing previously allocated volume resources. |
- Returns:
- FIO_VOLMAN_SUCCESS on success, otherwise failure.
Converts a fio_status_result_t to a fio_vol_mgmt_result_t.