Release Notes

Release notes and known issues.

New Features and Capabilities

For a listing of new features and capabilities, see Release Notes for 2024.1 .

Required Display Driver

You must install the NVIDIA display driver that supports the Nsight Graphics tools. If you have an NVIDIA graphics card installed on your target machine, you likely already have an NVIDIA display driver; however, Nsight Graphics requires a specific version of the driver in order to function properly. From the NVIDIA web site, download and install the following display driver:

Windows: Release 550.67 or newer

Linux: Release 550.67 or newer

Deprecations

Deprecated features or operating system support that will be removed in a future release

  • Support for OpenVR will be removed in a future release

Known Issues

General Known Issues

  1. Profiling of systems in an SLI configuration is not supported. Profiling of systems that have a mixture of Turing and pre-Turing hardware is not supported. To profile, make sure you have a only pre-Turing or Turing and beyond hardware in the system.

  2. Nsight Graphics requires a network connection to debug applications. This limitation will be addressed in a future release.

  3. Linux users: Applications that launch child processes are not fully supported in Nsight Graphics. This will be improved in a future version.

  4. If you experience a TDR on either your host or target system, it is recommended that you reboot your machine before trying to restart the debugging session. (22986)

  5. Forcing the target application to close through the task manager while in the Frame Debugger may crash the target application. We recommend using the “Terminate” command of the host over closing via the task manager.

  6. Windows DPI scaling is not respected in mixed-DPI scenarios with multiple monitors (always keys off main monitor).

  7. Paths with non-UTF8 characters are not supported as a document save location.

D3D Known Issues

  1. Because of driver restrictions, Nsight Graphics does not support creating a Direct3D 11 device with the Direct3D 9 feature set. This configuration may cause instability and application crashes. (32185)

  2. The Direct3D runtime documentation states that, “the return values of AddRef & Release may be unstable and should not be relied upon.” The Nsight Graphics Frame Debugger will also take additional references on objects so any code that relies on an exact reference count at a particular time may fail. In general, users should not expect an exact reference count to be returned from the Direct3D runtime. For more information, see Microsoft’s Rules for Managing Reference Counts. (30826)

  3. If you are passing the D3D11_MAP_FLAG_DO_NOT_WAIT to a Map call on a Direct3D 11 Device Context, it is possible that the operation hasn’t finished, and that you will see a return code of 0x887A000A or DXGI_ERROR_WAS_STILL_DRAWING. This can happen when the capture is trying to restore a buffer to the frame start state and it is mapped early in the frame. Simply remove the D3D11_MAP_FLAG_DO_NOT_WAIT, and it should function properly. (24846)

  4. Applications that intercept DirectX devices or objects by use of a shim object are not supported. This interferes with an internal mechanism and therefore cannot be handled properly. (14470)

  5. Nsight Graphics is incompatible with the debug runtime in all versions of Direct3D. While it may sometimes work, there are known incompatibilities that we are unable to support at this time.

  6. Compute dispatches on D3D11 may report long query times due to driver query batching limitations. This will be addressed in a future release. (DG-3114)

OpenGL Known Issues

  1. Using names that are generated by glGen* is advised for performance and correctness. Under normal operation, if an application uses a mix of generated and non-generated names (e.g. via a middleware product), there is the possibility of conflicts/aliases between names. When running an application under Nsight, Nsight will create its own resources that use names generated by the driver, further increasing the likelihood of conflicts. The recommended approach is to always use names that are generated by the driver via glGen*.

  2. If you are connected to your target using VNC and attempting to debug an OpenGL program, make sure to disable any “Hook” or “Mirror” driver option in the VNC server settings. (20686)

  3. Nsight Graphics may not work correctly unless double buffering is enabled by the application, since GLUT or other toolkits may skip the SwapBuffer calls for a single buffered window. (24590)

Vulkan Known Issues

  1. When running Vulkan applications, you need to leave some memory available for Nsight Graphics to use as staging areas on the GPU. If you get an out of memory warning on the host, this is a hint that you are hitting this problem.

  2. Vulkan support known limitations include:

    • OpenGL interop is not supported (e.g., glDrawVulkanImageNV).

  3. When running a C++ Capture of some large Vulkan applications on Linux, an error may be reported of “Too many resident pages”. This can be worked around by adjusting the MAX_RESIDENT_PAGES constant in Helpers.cpp.

Previous Versions

Below, you can find documentation on current and past releases for NVIDIA Nsight Graphics.

Documentation by Version

Additional Platforms

NVIDIA Nsight Graphics for Embedded

NVIDIA Nsight Graphics for DRIVE