PdhGetRawCounterValue
The PdhGetRawCounterValue
function returns the current raw value of the counter.
PDH_STATUS PdhGetRawCounterValue(
|
IN HCOUNTER hCounter, |
// handle of the
counter |
|
IN LPDWORD lpdwType, |
// counter type |
|
IN PPDH_RAW_COUNTER pValue |
// counter value |
|
); |
|
Parameters
hCounter
The handle of
the counter from which to retrieve the current raw value.
lpdwType
A pointer to
a DWORD buffer that will receive the counter type. The possible counter
types are described in WINPERF.H. This parameter is optional. You can pass NULL
if you don t want the type information.
pValue
A pointer to
the data buffer that will receive the counter value.
Return Values
If the
function succeeds, it returns ERROR_SUCCESS.
If the
function fails, the return value is a PDH error status defined in PDHMSG.H. The
following are possible error values:
PDH_INVALID_ARGUMENT
An argument
is not correct or is incorrectly formatted.
PDH_INVALID_HANDLE
The counter
handle is not valid.
Remarks
The data for
the counter is locked (protected) for the duration of the call to PdhGetRawCounterValue
to prevent any changes during processing of the call.
See Also