NVML API Reference Guide (PDF) - vR610 (older) - Last updated May 26, 2026 - Send Feedback

6.16. nvmlCPERCursor_v1_t Struct Reference

[CPER (Common Platform Error Record)]

CPER query and cursor parameters. Groups the filter options and opaque read position used to iterate through CPER records.

Cursor semantics for iterative calls:

  • Pass the same nvmlCPERCursor_v1_t (i.e. the same cursor) on every call in a single iteration sequence.

  • Do not modify this struct between calls.

  • To change cperTypeMask or uuid, set handle to NVML_CPER_CURSOR_HANDLE_INIT and call again with the updated filter (this starts a new iteration).

Public Variables

unsigned int  cperTypeMask
[IN] Types of records to access. Bitmask of nvmlCPERType_t values. To change, reset handle to NVML_CPER_CURSOR_HANDLE_INIT.
nvmlCPERCursorHandle_t handle
[IN/OUT] Opaque handle tracking read position. Initialize to NVML_CPER_CURSOR_HANDLE_INIT on first call; pass the same nvmlCPERCursor_v1_t on the next call to continue. Caller must not interpret or modify.
char  uuid[NVML_DEVICE_UUID_BUFFER_SIZE]
[IN] UUID of target to filter records for. Required for NVML_CPER_ACCESS_TYPE_GPU. To change, reset handle to NVML_CPER_CURSOR_HANDLE_INIT.

Variables

unsigned int nvmlCPERCursor_v1_t::cperTypeMask [inherited]

[IN] Types of records to access. Bitmask of nvmlCPERType_t values. To change, reset handle to NVML_CPER_CURSOR_HANDLE_INIT.

nvmlCPERCursorHandle_tnvmlCPERCursor_v1_t::handle [inherited]

[IN/OUT] Opaque handle tracking read position. Initialize to NVML_CPER_CURSOR_HANDLE_INIT on first call; pass the same nvmlCPERCursor_v1_t on the next call to continue. Caller must not interpret or modify.

char nvmlCPERCursor_v1_t::uuid[NVML_DEVICE_UUID_BUFFER_SIZE] [inherited]

[IN] UUID of target to filter records for. Required for NVML_CPER_ACCESS_TYPE_GPU. To change, reset handle to NVML_CPER_CURSOR_HANDLE_INIT.

NVML API Reference Guide (PDF) - vR610 (older) - Last updated May 26, 2026 - Send Feedback