0.0.0.1

Author: nohuto

CMakeLists.txt

@@ -1,28 +1,17 @@
 cmake_minimum_required(VERSION 3.20)
 project(nvapi-cli LANGUAGES CXX RC)
 
-set(CMAKE_CXX_STANDARD 17)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-set(CMAKE_CXX_EXTENSIONS OFF)
-
-file(GLOB CLI_SOURCES CONFIGURE_DEPENDS
-    "${CMAKE_SOURCE_DIR}/src/cli/*.cpp"
-)
+file(GLOB CLI_SOURCES CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/src/cli/*.cpp")
 
 add_executable(nvapi-cli
     src/nvapi-cli.cpp
     src/nvapi-cli.rc
     ${CLI_SOURCES}
 )
 
-target_include_directories(nvapi-cli PRIVATE
-    "${CMAKE_SOURCE_DIR}/include"
-)
-
-target_compile_definitions(nvapi-cli PRIVATE
-    WIN32
-    NOMINMAX
-)
+target_compile_features(nvapi-cli PRIVATE cxx_std_17)
+target_include_directories(nvapi-cli PRIVATE "${CMAKE_SOURCE_DIR}/include")
+target_compile_definitions(nvapi-cli PRIVATE WIN32 NOMINMAX)
 
 if(MSVC)
     target_compile_options(nvapi-cli PRIVATE /W4 /EHsc)

README.md

@@ -2,12 +2,12 @@
 
 CLI wrapper around NVIDIA's NVAPI for querying and controlling GPU, display, and driver features on Windows. NVAPI is NVIDIA's proprietary driver API that exposes GPU and display capabilities beyond the standard OS interfaces. It's hardware and driver dependent, many functions are supported only on specific GPUs, drivers, or product lines. Expect `NVAPI_NOT_SUPPORTED` for unsupported features.
 
-Note that the documentation is partly parsed from official documentation partly rewritten by myself.
+Note that the documentation is partly parsed from official documentation partly rewritten by myself. The tool isn't yet in its final state, more useful APIs may be added.
 
 > [!CAUTION]
 > Use the tool with caution when applying control APIs, I'm not responsible for any damage/issues. This tool is in BETA state, bugs may exist. I didn't test each option on my own yet.
 
-[assets/supported_nvapi.txt](https://github.com/nohuto/nvapi-cli/blob/main/assets/supported_nvapi.txt) includes all NVAPI functions referenced by the current source code. [assets/unsupported_nvapi.txt](https://github.com/nohuto/nvapi-cli/blob/main/assets/unsupported_nvapi.txt) includes NVAPI functions present in `nvapi.h` but not used by the current version.
+[assets/supported_nvapi.txt](https://github.com/nohuto/nvapi-cli/blob/main/assets/supported_nvapi.txt) includes all NVAPI functions referenced by the current source code. [assets/unsupported_nvapi.txt](https://github.com/nohuto/nvapi-cli/blob/main/assets/unsupported_nvapi.txt) includes NVAPI functions present in the NVAPI SDK header (`nvapi.h`) but not used by the current version.
 
 ## Usage
 
@@ -24,6 +24,13 @@ Use "nvapi-cli help <group>" or "nvapi-cli <group> help" for details.
 Use "nvapi-cli help all" for the full list.
 ```
 
+## Building
+
+```powershell
+cmake -S . -B build
+cmake --build build --config Release
+```
+
 ## Documentation
 
 Each group has a dedicated reference that lists commands, flags, and the underlying NVAPI calls.
@@ -42,4 +49,6 @@ Each group has a dedicated reference that lists commands, flags, and the underly
 - [docs/d3d.md](https://github.com/nohuto/nvapi-cli/blob/main/docs/d3d.md) - Direct3D toolchain helpers (VRR, Ansel...)
 - [docs/ogl.md](https://github.com/nohuto/nvapi-cli/blob/main/docs/ogl.md) - OpenGL expert mode settings
 - [docs/vr.md](https://github.com/nohuto/nvapi-cli/blob/main/docs/vr.md) - Direct mode display controls
-- [docs/stereo.md](https://github.com/nohuto/nvapi-cli/blob/main/docs/stereo.md) - Stereo 3D and driver registry controls
+- [docs/stereo.md](https://github.com/nohuto/nvapi-cli/blob/main/docs/stereo.md) - Stereo 3D and driver registry controls
+
+Public NvAPI documentation: https://docs.nvidia.com/gameworks/content/gameworkslibrary/coresdk/nvapi/topics.html

assets/supported_nvapi.txt

@@ -85,6 +85,9 @@ NvAPI_GPU_ClientPowerPoliciesGetStatus
 NvAPI_GPU_ClientPowerPoliciesSetStatus
 NvAPI_GPU_ClientPowerTopologyGetInfo
 NvAPI_GPU_ClientPowerTopologyGetStatus
+NvAPI_GPU_ClientRevertOc
+NvAPI_GPU_ClientStartOcScanner
+NvAPI_GPU_ClientStopOcScanner
 NvAPI_GPU_ClientThermalPoliciesGetInfo
 NvAPI_GPU_ClientThermalPoliciesGetStatus
 NvAPI_GPU_ClientThermalPoliciesSetStatus
@@ -140,6 +143,8 @@ NvAPI_GPU_ClockNafllDevicesGetInfo
 NvAPI_GPU_ClockNafllDevicesGetStatus
 NvAPI_GPU_ClockNafllDevicesSetControl
 NvAPI_GPU_ClockPmumonClkDomainsGetSamples
+NvAPI_GPU_ControlASPM
+NvAPI_GPU_EnableDynamicPstates
 NvAPI_GPU_FanArbiterGetInfo
 NvAPI_GPU_FanArbiterGetStatus
 NvAPI_GPU_FanCoolerGetControl
@@ -152,6 +157,8 @@ NvAPI_GPU_FanPolicyGetInfo
 NvAPI_GPU_FanPolicyGetStatus
 NvAPI_GPU_FanPolicySetControl
 NvAPI_GPU_FanTestGetInfo
+NvAPI_GPU_ForceGC6Exit
+NvAPI_GPU_GC6Control
 NvAPI_GPU_GetAllClockFrequencies
 NvAPI_GPU_GetAllDisplayIds
 NvAPI_GPU_GetBarInfo
@@ -161,10 +168,14 @@ NvAPI_GPU_GetBusSlotId
 NvAPI_GPU_GetBusType
 NvAPI_GPU_GetConnectedDisplayIds
 NvAPI_GPU_GetConnectedSLIOutputs
+NvAPI_GPU_GetCoolerPolicyTable
 NvAPI_GPU_GetCoolerSettings
 NvAPI_GPU_GetCoreVoltage
 NvAPI_GPU_GetCoreVoltageControl
 NvAPI_GPU_GetCurrentPstate
+NvAPI_GPU_GetCurrentThermalLevel
+NvAPI_GPU_GetDeepIdleState
+NvAPI_GPU_GetDeepIdleStatistics
 NvAPI_GPU_GetDynamicPstatesInfoEx
 NvAPI_GPU_GetECCConfigurationInfo
 NvAPI_GPU_GetECCErrorInfo
@@ -231,9 +242,18 @@ NvAPI_GPU_PowerPolicyGetStatus
 NvAPI_GPU_PowerPolicySetControl
 NvAPI_GPU_QueryDPTopology
 NvAPI_GPU_ResetECCErrorInfo
+NvAPI_GPU_RestoreCoolerPolicyTable
 NvAPI_GPU_RestoreCoolerSettings
 NvAPI_GPU_SetCoolerLevels
+NvAPI_GPU_SetCoolerPolicyTable
 NvAPI_GPU_SetCoreVoltageControl
+NvAPI_GPU_SetCurrentPCIESpeed
+NvAPI_GPU_SetCurrentPCIEWidth
+NvAPI_GPU_SetDeepIdleState
+NvAPI_GPU_SetDeepIdleStatisticsMode
+NvAPI_GPU_SetECCConfiguration
+NvAPI_GPU_SetForcePstate
+NvAPI_GPU_SetForcePstateEx
 NvAPI_GPU_SetPerfLimit
 NvAPI_GPU_SetPstates20
 NvAPI_GPU_SetPstates20Private
@@ -254,6 +274,8 @@ NvAPI_GPU_ThermalPolicyGetControl
 NvAPI_GPU_ThermalPolicyGetInfo
 NvAPI_GPU_ThermalPolicyGetStatus
 NvAPI_GPU_ThermalPolicySetControl
+NvAPI_GSync_DisableSync
+NvAPI_GSync_EnableSync
 NvAPI_GSync_EnumSyncDevices
 NvAPI_GSync_GetControlParameters
 NvAPI_GSync_GetStatusParameters
@@ -367,4 +389,4 @@ NvAPI_Stereo_Trigger_Activation
 NvAPI_UnloadEx
 NvAPI_Video_ColorControl_Get
 NvAPI_Video_ColorControl_GetDefault
-NvAPI_Video_ColorControl_Set
+NvAPI_Video_ColorControl_Set

assets/unsupported_nvapi.txt

@@ -856,28 +856,21 @@ NvAPI_GPU_ClientRegisterForPowerSampleUpdates
 NvAPI_GPU_ClientRegisterForThermalSampleUpdates
 NvAPI_GPU_ClientRegisterForUtilizationSampleUpdates
 NvAPI_GPU_ClientRegisterForVoltageSampleUpdates
-NvAPI_GPU_ClientRevertOc
-NvAPI_GPU_ClientStartOcScanner
-NvAPI_GPU_ClientStopOcScanner
 NvAPI_GPU_ClientVoltRailsGetControl
 NvAPI_GPU_ClientVoltRailsGetStatus
 NvAPI_GPU_ClientVoltRailsSetControl
-NvAPI_GPU_ControlASPM
 NvAPI_GPU_ConvertStringHashToPhysicalGpu
 NvAPI_GPU_CreateStringHashFromPhysicalGpu
 NvAPI_GPU_CudaEnumComputeCapableGpus
 NvAPI_GPU_DisableD3ColdSupportOnStopDevice
 NvAPI_GPU_DisableLicensedFeature
-NvAPI_GPU_EnableDynamicPstates
 NvAPI_GPU_EnableLicensedFeature
 NvAPI_GPU_EnableOverclockedPstates
 NvAPI_GPU_EnumClusterTopologies
 NvAPI_GPU_FbPatchPbrForMining
 NvAPI_GPU_FbSetReadLimit
 NvAPI_GPU_FbSetRrd
 NvAPI_GPU_FbSetWriteLimit
-NvAPI_GPU_ForceGC6Exit
-NvAPI_GPU_GC6Control
 NvAPI_GPU_GPIOQueryLegalPins
 NvAPI_GPU_GPIOReadFromPin
 NvAPI_GPU_GPIOWriteToPin
@@ -908,14 +901,10 @@ NvAPI_GPU_GetConnectedSLIOutputsWithLidStateEx
 NvAPI_GPU_GetConnectorInfo
 NvAPI_GPU_GetConnectorInfoEx
 NvAPI_GPU_GetConnectorState
-NvAPI_GPU_GetCoolerPolicyTable
 NvAPI_GPU_GetCurrentAGPRate
 NvAPI_GPU_GetCurrentFanSpeedLevel
 NvAPI_GPU_GetCurrentPCIEDownstreamWidth
-NvAPI_GPU_GetCurrentThermalLevel
 NvAPI_GPU_GetCyaAspmInfo
-NvAPI_GPU_GetDeepIdleState
-NvAPI_GPU_GetDeepIdleStatistics
 NvAPI_GPU_GetDeviceDisplayMode
 NvAPI_GPU_GetDisplayChangeInhibitState
 NvAPI_GPU_GetDisplayUnderflowStatus
@@ -1193,28 +1182,19 @@ NvAPI_GPU_QueryIsGRIDDisplayless
 NvAPI_GPU_QueryNodeInfo
 NvAPI_GPU_QueryWorkstationFeatureSupport
 NvAPI_GPU_RegisterOp
-NvAPI_GPU_RestoreCoolerPolicyTable
 NvAPI_GPU_SetActivationState
 NvAPI_GPU_SetAudioDeviceEntryPriorityList
 NvAPI_GPU_SetAudioStreams
 NvAPI_GPU_SetClocks
 NvAPI_GPU_SetClocksShmoo
 NvAPI_GPU_SetColorSpaceConversion
 NvAPI_GPU_SetComputePrecision
-NvAPI_GPU_SetCoolerPolicyTable
-NvAPI_GPU_SetCurrentPCIESpeed
-NvAPI_GPU_SetCurrentPCIEWidth
-NvAPI_GPU_SetDeepIdleState
-NvAPI_GPU_SetDeepIdleStatisticsMode
 NvAPI_GPU_SetDisplayUnderflowMode
 NvAPI_GPU_SetDitherControl
-NvAPI_GPU_SetECCConfiguration
 NvAPI_GPU_SetEDID
 NvAPI_GPU_SetEDIDInternal
 NvAPI_GPU_SetExtendedThermalSimulationMode
 NvAPI_GPU_SetExternPowerState
-NvAPI_GPU_SetForcePstate
-NvAPI_GPU_SetForcePstateEx
 NvAPI_GPU_SetIllumination
 NvAPI_GPU_SetOptimizationData
 NvAPI_GPU_SetPCIELtrInfo
@@ -1257,8 +1237,6 @@ NvAPI_GPU_WorkstationFeatureCommit
 NvAPI_GPU_WorkstationFeatureQuery
 NvAPI_GPU_WorkstationFeatureSetup
 NvAPI_GSync_AdjustSyncDelay
-NvAPI_GSync_DisableSync
-NvAPI_GSync_EnableSync
 NvAPI_GSync_FPGAFlashHelper
 NvAPI_GSync_Get_DiagnosticSettings
 NvAPI_GSync_QueryInterlaceMode
@@ -1679,4 +1657,4 @@ NvAPI_Xcode_GetDecodeInfo
 NvAPI_Xcode_GetEncodeInfo
 NvAPI_Xcode_GetNvapiDMAInfo
 NvAPI_Xcode_SetDecodeInfo
-NvAPI_Xcode_SetEncodeInfo
+NvAPI_Xcode_SetEncodeInfo