GPU ECC Interface

Data Structures
struct	NV_GPU_ECC_STATUS_INFO
struct	NV_GPU_ECC_ERROR_INFO
struct	NV_GPU_ECC_CONFIGURATION_INFO

Macros
#define	NV_GPU_ECC_STATUS_INFO_VER   MAKE_NVAPI_VERSION(NV_GPU_ECC_STATUS_INFO,1)
#define	NV_GPU_ECC_ERROR_INFO_VER   MAKE_NVAPI_VERSION(NV_GPU_ECC_ERROR_INFO,1)
#define	NV_GPU_ECC_CONFIGURATION_INFO_VER   MAKE_NVAPI_VERSION(NV_GPU_ECC_CONFIGURATION_INFO,1)

Functions
NVAPI_INTERFACE	NvAPI_GPU_GetECCStatusInfo (NvPhysicalGpuHandle hPhysicalGpu, NV_GPU_ECC_STATUS_INFO *pECCStatusInfo)
NVAPI_INTERFACE	NvAPI_GPU_GetECCErrorInfo (NvPhysicalGpuHandle hPhysicalGpu, NV_GPU_ECC_ERROR_INFO *pECCErrorInfo)
NVAPI_INTERFACE	NvAPI_GPU_ResetECCErrorInfo (NvPhysicalGpuHandle hPhysicalGpu, NvU8 bResetCurrent, NvU8 bResetAggregate)
NVAPI_INTERFACE	NvAPI_GPU_GetECCConfigurationInfo (NvPhysicalGpuHandle hPhysicalGpu, NV_GPU_ECC_CONFIGURATION_INFO *pECCConfigurationInfo)
NVAPI_INTERFACE	NvAPI_GPU_SetECCConfiguration (NvPhysicalGpuHandle hPhysicalGpu, NvU8 bEnable, NvU8 bEnableImmediately)

Detailed Description

The GPU ECC APIs are used to configure ECC-capable GPUs.

Used in NV_GPU_ECC_STATUS_INFO.

Macro Definition Documentation

NV_GPU_ECC_CONFIGURATION_INFO_VER

#define NV_GPU_ECC_CONFIGURATION_INFO_VER   MAKE_NVAPI_VERSION(NV_GPU_ECC_CONFIGURATION_INFO,1)

Macro for consstructing the verion field of NV_GPU_ECC_CONFIGURATION_INFO

NV_GPU_ECC_ERROR_INFO_VER

#define NV_GPU_ECC_ERROR_INFO_VER   MAKE_NVAPI_VERSION(NV_GPU_ECC_ERROR_INFO,1)

Macro for constructing the version field of NV_GPU_ECC_ERROR_INFO

NV_GPU_ECC_STATUS_INFO_VER

#define NV_GPU_ECC_STATUS_INFO_VER   MAKE_NVAPI_VERSION(NV_GPU_ECC_STATUS_INFO,1)

Macro for constructing the version field of NV_GPU_ECC_STATUS_INFO

Function Documentation

NvAPI_GPU_GetECCConfigurationInfo()

NVAPI_INTERFACE NvAPI_GPU_GetECCConfigurationInfo	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NV_GPU_ECC_CONFIGURATION_INFO *	pECCConfigurationInfo
	)

NvAPI_GPU_GetECCErrorInfo()

NVAPI_INTERFACE NvAPI_GPU_GetECCErrorInfo	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NV_GPU_ECC_ERROR_INFO *	pECCErrorInfo
	)

NvAPI_GPU_GetECCStatusInfo()

NVAPI_INTERFACE NvAPI_GPU_GetECCStatusInfo	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NV_GPU_ECC_STATUS_INFO *	pECCStatusInfo
	)

NvAPI_GPU_ResetECCErrorInfo()

NVAPI_INTERFACE NvAPI_GPU_ResetECCErrorInfo	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NvU8	bResetCurrent,
		NvU8	bResetAggregate
	)

DESCRIPTION: This function resets ECC memory error counters.

SUPPORTED OS: Windows 10 and higher

TCC_SUPPORTED

\requires Administrator privileges since release 430.39

Parameters

[in]	hPhysicalGpu	A handle identifying the physical GPU for which ECC error information is to be cleared.
[in]	bResetCurrent	Reset the current ECC error counters.
[in]	bResetAggregate	Reset the aggregate ECC error counters.

Returns

This API can return any of the error codes enumerated in NvAPI_Status. If there are return error codes with specific meaning for this API, they are listed below.

Return values

NVAPI_INVALID_USER_PRIVILEGE

- The application will require Administrator privileges to access this API. The application can be elevated to a higher permission level by selecting "Run as Administrator".

NvAPI_GPU_SetECCConfiguration()

NVAPI_INTERFACE NvAPI_GPU_SetECCConfiguration	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NvU8	bEnable,
		NvU8	bEnableImmediately
	)

DESCRIPTION: This function updates the ECC memory configuration setting.

SUPPORTED OS: Windows 10 and higher

TCC_SUPPORTED

\requires Administrator privileges since release 430.39

Parameters

[in]	hPhysicalGpu	A handle identifying the physical GPU for which to update the ECC configuration setting.
[in]	bEnable	The new ECC configuration setting.
[in]	bEnableImmediately	Request that the new setting take effect immediately.

Returns

This API can return any of the error codes enumerated in NvAPI_Status. If there are return error codes with specific meaning for this API, they are listed below.

Return values

NVAPI_INVALID_CONFIGURATION	- Possibly SLI is enabled. Disable SLI and retry.
NVAPI_INVALID_USER_PRIVILEGE	- The application will require Administrator privileges to access this API. The application can be elevated to a higher permission level by selecting "Run as Administrator".