Hitachi HF-W6500 45/40, Feature Manual

Page: 124 / 163

6. LIBRARY FUNCTIONS
6-19
6.1.8 Get function for the failure prediction status of the drive (GetHddPredict)
<Name>
GetHddPredict - Get function for the failure prediction status of the drive
<Syntax>
#include <w2kras.h>
BOOL GetHddPredict(PHDD_PREDICT_DATA pHddData);
<Description>
This function acquires the failure prediction status of the internal drives of this equipment.
In order to use this function, in the
RAS Setup
window, select the “
Function is available
”
check box under
Drive failure prediction setting (SMART)
. If this check box is cleared, this
function terminates with an error. If you call the GetLastError Windows API function, an error
code W2KRAS_HDDPREDICT_INVALID is returned. The parameters of this function are
explained below.
NOTE
If the operating system is a 64-bit version, this function is not supported. Use
the function (hfwDiskStat) provided as an alternative.
pHddData:
This parameter specifies a pointer to an HDD_PREDICT_DATA structure shown below that
stores the acquired drive failure prediction status.
typedef struct HDD_PREDICT_DATA {
DWORD Hdd1_Predict; //Failure prediction status of the drive on the drive bay1
DWORD Hdd2_Predict; //Failure prediction status of the drive on the drive bay2
} HDD_PREDICT_DATA, *PHDD_PREDICT_DATA;
Each element of the HDD_PREDICT_DATA structure above stores a value described in
Table 6-8 when this function returns successfully.
Table 6-8 List of Values Stored in Each Element of the HDD_PREDICT_DATA Sstructure
Value Meaning
HDD_PREDICT_OFF (0x00) The HDD is working properly.
HDD_PREDICT_ON (0x01) Failure is anticipated.
HDD_NOT_CONNECTED (0x02) A drive is not connected.
HDD_PREDICT_FAILURE (0x03) Acquiring the failure prediction status failed.