IToiStorageObserver Interface Reference


Description

This interface is used to receive events from the Storage Service.

See also:
IToiStorageService::RegisterObserver()
Note:
Services or applications may choose to inherit the adapter class TToiStorageObserverAdapter, which provides a default empty implementation of IToiStorageObserver.

import "IToiStorageObserver.idl";

List of all members.

Public Member Functions

oneway void OnDeviceConnected (in IToiStorageDevice::TToiStorageInfo info)
oneway void OnDeviceDisconnected (in IToiStorageDevice::TToiStorageInfo info)
oneway void OnDeviceSpinningChanged (in IToiStorageDevice::TToiStorageInfo info)
oneway void OnDevicePartitionsChanged (in IToiStorageDevice::TToiStorageInfo info)
oneway void OnDevicePartitionMountChanged (in IToiStorageDevice::TToiStorageInfo info, in IToiStorageDevice::TToiPartitionInfo partitionInfo)
oneway void OnDevicePartitionFull (in IToiStorageDevice::TToiStorageInfo info, in IToiStorageDevice::TToiPartitionInfo partitionInfo, in long long spaceRequired)
oneway void OnDeviceTemperatureThresholdReached (in IToiStorageDevice::TToiStorageInfo info, in string thresholdName)

Member Function Documentation

oneway void IToiStorageObserver::OnDeviceConnected ( in IToiStorageDevice::TToiStorageInfo  info  ) 

Called when a storage device is connected. Typically occurs for USB connected devices.

Parameters:
info Storage information for the device.
oneway void IToiStorageObserver::OnDeviceDisconnected ( in IToiStorageDevice::TToiStorageInfo  info  ) 

Called when a storage device is disconnected. The IToiStorageDevice instance is not released by IToiStorageService until reboot time. Typically occurs for USB connected devices.

Parameters:
info Storage information for the device.
oneway void IToiStorageObserver::OnDevicePartitionFull ( in IToiStorageDevice::TToiStorageInfo  info,
in IToiStorageDevice::TToiPartitionInfo  partitionInfo,
in long long  spaceRequired 
)

Called if a partition holding platform data (such as DVR recordings) becomes full. The callback will occur periodically as long as the partition is full and operations such as DVR recordings will not be possible until the requested number of bytes are freed. Once this has happen, the callback will occur a final time with spaceRequired set to 0 to indicate that enough free space is now available.

Parameters:
info The storage information for the device.
partitionInfo The partition information for the mounted/unmounted partition.
spaceRequired Number of bytes that must be freed for the disk to become non-full.
oneway void IToiStorageObserver::OnDevicePartitionMountChanged ( in IToiStorageDevice::TToiStorageInfo  info,
in IToiStorageDevice::TToiPartitionInfo  partitionInfo 
)

Called when a partition is mounted/unmounted (either auto-mount or explicit by application).

Parameters:
info Storage information for the device.
partitionInfo Partition information for the mounted/unmounted partition.
oneway void IToiStorageObserver::OnDevicePartitionsChanged ( in IToiStorageDevice::TToiStorageInfo  info  ) 

Called when partitions have been added or removed, typically when a reformat has been performed.

Parameters:
info Storage information for the device.
oneway void IToiStorageObserver::OnDeviceSpinningChanged ( in IToiStorageDevice::TToiStorageInfo  info  ) 

Called when the storage device spins up/down. When the storage device spins up/down for other reasons than because of calls to IToiStorageDevice::SpinUp() and IToiStorageDevice::SpinDown(), this event may be delayed for several seconds. Also, if the device spins back to its previous state within this period, OnDeviceSpinningChanged() will not be called.

Parameters:
info Storage information for the device.
oneway void IToiStorageObserver::OnDeviceTemperatureThresholdReached ( in IToiStorageDevice::TToiStorageInfo  info,
in string  thresholdName 
)

Called when a temperature threshold has been reached.

Parameters:
info Storage information for the device.
thresholdName Name of the reached threshold.