542 lines
35 KiB
C
542 lines
35 KiB
C
/************************************************************************************************************************************\
|
|
|* *|
|
|
|* Copyright © 2012 NVIDIA Corporation. All rights reserved. *|
|
|
|* *|
|
|
|* NOTICE TO USER: *|
|
|
|* *|
|
|
|* This software is subject to NVIDIA ownership rights under U.S. and international Copyright laws. *|
|
|
|* *|
|
|
|* This software and the information contained herein are PROPRIETARY and CONFIDENTIAL to NVIDIA *|
|
|
|* and are being provided solely under the terms and conditions of an NVIDIA software license agreement. *|
|
|
|* Otherwise, you have no rights to use or access this software in any manner. *|
|
|
|* *|
|
|
|* If not covered by the applicable NVIDIA software license agreement: *|
|
|
|* NVIDIA MAKES NO REPRESENTATION ABOUT THE SUITABILITY OF THIS SOFTWARE FOR ANY PURPOSE. *|
|
|
|* IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY OF ANY KIND. *|
|
|
|* NVIDIA DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, *|
|
|
|* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. *|
|
|
|* IN NO EVENT SHALL NVIDIA BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, *|
|
|
|* OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, *|
|
|
|* NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOURCE CODE. *|
|
|
|* *|
|
|
|* U.S. Government End Users. *|
|
|
|* This software is a "commercial item" as that term is defined at 48 C.F.R. 2.101 (OCT 1995), *|
|
|
|* consisting of "commercial computer software" and "commercial computer software documentation" *|
|
|
|* as such terms are used in 48 C.F.R. 12.212 (SEPT 1995) and is provided to the U.S. Government only as a commercial end item. *|
|
|
|* Consistent with 48 C.F.R.12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (JUNE 1995), *|
|
|
|* all U.S. Government End Users acquire the software with only those rights set forth herein. *|
|
|
|* *|
|
|
|* Any use of this software in individual and commercial software must include, *|
|
|
|* in the user documentation and internal comments to the code, *|
|
|
|* the above Disclaimer (as applicable) and U.S. Government End Users Notice. *|
|
|
|* *|
|
|
\************************************************************************************************************************************/
|
|
#pragma once
|
|
#include"nvapi_lite_salstart.h"
|
|
#pragma pack(push,8)
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
#if (defined(WIN32) || defined(_WIN32)) && defined(_MSC_VER) && (_MSC_VER > 1399) && !defined(NVAPI_INTERNAL) && !defined(NVAPI_DEPRECATED_OLD)
|
|
#ifndef __nvapi_deprecated_function
|
|
#define __nvapi_deprecated_function(message) __declspec(deprecated(message))
|
|
#endif
|
|
#ifndef __nvapi_deprecated_datatype
|
|
#define __nvapi_deprecated_datatype(FirstRelease) __declspec(deprecated("Do not use this data type - it is deprecated in release " #FirstRelease "."))
|
|
#endif
|
|
#else
|
|
#ifndef __nvapi_deprecated_function
|
|
#define __nvapi_deprecated_function(message)
|
|
#endif
|
|
#ifndef __nvapi_deprecated_datatype
|
|
#define __nvapi_deprecated_datatype(FirstRelease)
|
|
#endif
|
|
#endif
|
|
|
|
|
|
/* 64-bit types for compilers that support them, plus some obsolete variants */
|
|
#if defined(__GNUC__) || defined(__arm) || defined(__IAR_SYSTEMS_ICC__) || defined(__ghs__) || defined(_WIN64)
|
|
typedef unsigned long long NvU64; /* 0 to 18446744073709551615 */
|
|
typedef long long NvS64; /* -9223372036854775808 to 9223372036854775807 */
|
|
#else
|
|
typedef unsigned __int64 NvU64; /* 0 to 18446744073709551615 */
|
|
typedef __int64 NvS64; /* -9223372036854775808 to 9223372036854775807 */
|
|
#endif
|
|
|
|
// mac os 32-bit still needs this
|
|
#if (defined(macintosh) || defined(__APPLE__)) && !defined(__LP64__)
|
|
typedef signed long NvS32; /* -2147483648 to 2147483647 */
|
|
#else
|
|
typedef signed int NvS32; /* -2147483648 to 2147483647 */
|
|
#endif
|
|
|
|
#ifndef __unix
|
|
// mac os 32-bit still needs this
|
|
#if ( (defined(macintosh) && defined(__LP64__) && (__NVAPI_RESERVED0__)) || \
|
|
(!defined(macintosh) && defined(__NVAPI_RESERVED0__)) )
|
|
typedef unsigned int NvU32; /* 0 to 4294967295 */
|
|
#else
|
|
typedef unsigned long NvU32; /* 0 to 4294967295 */
|
|
#endif
|
|
#else
|
|
typedef unsigned int NvU32; /* 0 to 4294967295 */
|
|
#endif
|
|
|
|
typedef unsigned long temp_NvU32; /* 0 to 4294967295 */
|
|
typedef signed short NvS16;
|
|
typedef unsigned short NvU16;
|
|
typedef unsigned char NvU8;
|
|
typedef signed char NvS8;
|
|
|
|
/* Boolean type */
|
|
typedef NvU8 NvBool;
|
|
#define NV_TRUE ((NvBool)(0 == 0))
|
|
#define NV_FALSE ((NvBool)(0 != 0))
|
|
|
|
|
|
typedef struct _NV_RECT
|
|
{
|
|
NvU32 left;
|
|
NvU32 top;
|
|
NvU32 right;
|
|
NvU32 bottom;
|
|
} NV_RECT;
|
|
|
|
|
|
|
|
#define NV_DECLARE_HANDLE(name) struct name##__ { int unused; }; typedef struct name##__ *name
|
|
|
|
//! \addtogroup nvapihandles
|
|
//! NVAPI Handles - These handles are retrieved from various calls and passed in to others in NvAPI
|
|
//! These are meant to be opaque types. Do not assume they correspond to indices, HDCs,
|
|
//! display indexes or anything else.
|
|
//!
|
|
//! Most handles remain valid until a display re-configuration (display mode set) or GPU
|
|
//! reconfiguration (going into or out of SLI modes) occurs. If NVAPI_HANDLE_INVALIDATED
|
|
//! is received by an app, it should discard all handles, and re-enumerate them.
|
|
//! @{
|
|
NV_DECLARE_HANDLE(NvDisplayHandle); //!< Display Device driven by NVIDIA GPU(s) (an attached display)
|
|
NV_DECLARE_HANDLE(NvMonitorHandle); //!< Monitor handle
|
|
NV_DECLARE_HANDLE(NvUnAttachedDisplayHandle); //!< Unattached Display Device driven by NVIDIA GPU(s)
|
|
NV_DECLARE_HANDLE(NvLogicalGpuHandle); //!< One or more physical GPUs acting in concert (SLI)
|
|
NV_DECLARE_HANDLE(NvPhysicalGpuHandle); //!< A single physical GPU
|
|
NV_DECLARE_HANDLE(NvEventHandle); //!< A handle to an event registration instance
|
|
NV_DECLARE_HANDLE(NvVisualComputingDeviceHandle); //!< A handle to a Visual Computing Device
|
|
NV_DECLARE_HANDLE(NvHICHandle); //!< A handle to a Host Interface Card
|
|
NV_DECLARE_HANDLE(NvGSyncDeviceHandle); //!< A handle to a Sync device
|
|
NV_DECLARE_HANDLE(NvVioHandle); //!< A handle to an SDI device
|
|
NV_DECLARE_HANDLE(NvTransitionHandle); //!< A handle to address a single transition request
|
|
NV_DECLARE_HANDLE(NvAudioHandle); //!< NVIDIA HD Audio Device
|
|
NV_DECLARE_HANDLE(Nv3DVPContextHandle); //!< A handle for a 3D Vision Pro (3DVP) context
|
|
NV_DECLARE_HANDLE(Nv3DVPTransceiverHandle); //!< A handle for a 3DVP RF transceiver
|
|
NV_DECLARE_HANDLE(Nv3DVPGlassesHandle); //!< A handle for a pair of 3DVP RF shutter glasses
|
|
|
|
typedef void* StereoHandle; //!< A stereo handle, that corresponds to the device interface
|
|
|
|
NV_DECLARE_HANDLE(NvSourceHandle); //!< Unique source handle on the system
|
|
NV_DECLARE_HANDLE(NvTargetHandle); //!< Unique target handle on the system
|
|
NV_DECLARE_HANDLE(NVDX_SwapChainHandle); //!< DirectX SwapChain objects
|
|
static const NVDX_SwapChainHandle NVDX_SWAPCHAIN_NONE = 0;
|
|
//! @}
|
|
|
|
//! \ingroup nvapihandles
|
|
//! @{
|
|
#define NVAPI_DEFAULT_HANDLE 0
|
|
#define NV_BIT(x) (1 << (x))
|
|
//! @}
|
|
|
|
|
|
|
|
//! \addtogroup nvapitypes
|
|
//! @{
|
|
#define NVAPI_GENERIC_STRING_MAX 4096
|
|
#define NVAPI_LONG_STRING_MAX 256
|
|
#define NVAPI_SHORT_STRING_MAX 64
|
|
|
|
|
|
typedef struct
|
|
{
|
|
NvS32 sX;
|
|
NvS32 sY;
|
|
NvS32 sWidth;
|
|
NvS32 sHeight;
|
|
} NvSBox;
|
|
|
|
#ifndef NvGUID_Defined
|
|
#define NvGUID_Defined
|
|
|
|
typedef struct
|
|
{
|
|
NvU32 data1;
|
|
NvU16 data2;
|
|
NvU16 data3;
|
|
NvU8 data4[8];
|
|
} NvGUID, NvLUID;
|
|
|
|
#endif //#ifndef NvGUID_Defined
|
|
|
|
|
|
#define NVAPI_MAX_PHYSICAL_GPUS 64
|
|
#define NVAPI_MAX_PHYSICAL_BRIDGES 100
|
|
#define NVAPI_PHYSICAL_GPUS 32
|
|
#define NVAPI_MAX_LOGICAL_GPUS 64
|
|
#define NVAPI_MAX_AVAILABLE_GPU_TOPOLOGIES 256
|
|
#define NVAPI_MAX_AVAILABLE_SLI_GROUPS 256
|
|
#define NVAPI_MAX_GPU_TOPOLOGIES NVAPI_MAX_PHYSICAL_GPUS
|
|
#define NVAPI_MAX_GPU_PER_TOPOLOGY 8
|
|
#define NVAPI_MAX_DISPLAY_HEADS 2
|
|
#define NVAPI_ADVANCED_DISPLAY_HEADS 4
|
|
#define NVAPI_MAX_DISPLAYS NVAPI_PHYSICAL_GPUS * NVAPI_ADVANCED_DISPLAY_HEADS
|
|
#define NVAPI_MAX_ACPI_IDS 16
|
|
#define NVAPI_MAX_VIEW_MODES 8
|
|
#define NV_MAX_HEADS 4 //!< Maximum heads, each with NVAPI_DESKTOP_RES resolution
|
|
#define NVAPI_MAX_HEADS_PER_GPU 32
|
|
|
|
#define NV_MAX_HEADS 4 //!< Maximum number of heads, each with #NVAPI_DESKTOP_RES resolution
|
|
#define NV_MAX_VID_STREAMS 4 //!< Maximum number of input video streams, each with a #NVAPI_VIDEO_SRC_INFO
|
|
#define NV_MAX_VID_PROFILES 4 //!< Maximum number of output video profiles supported
|
|
|
|
#define NVAPI_SYSTEM_MAX_DISPLAYS NVAPI_MAX_PHYSICAL_GPUS * NV_MAX_HEADS
|
|
|
|
#define NVAPI_SYSTEM_MAX_HWBCS 128
|
|
#define NVAPI_SYSTEM_HWBC_INVALID_ID 0xffffffff
|
|
#define NVAPI_MAX_AUDIO_DEVICES 16
|
|
|
|
|
|
typedef char NvAPI_String[NVAPI_GENERIC_STRING_MAX];
|
|
typedef char NvAPI_LongString[NVAPI_LONG_STRING_MAX];
|
|
typedef char NvAPI_ShortString[NVAPI_SHORT_STRING_MAX];
|
|
//! @}
|
|
|
|
|
|
// =========================================================================================
|
|
//! NvAPI Version Definition \n
|
|
//! Maintain per structure specific version define using the MAKE_NVAPI_VERSION macro. \n
|
|
//! Usage: #define NV_GENLOCK_STATUS_VER MAKE_NVAPI_VERSION(NV_GENLOCK_STATUS, 1)
|
|
//! \ingroup nvapitypes
|
|
// =========================================================================================
|
|
#define MAKE_NVAPI_VERSION(typeName,ver) (NvU32)(sizeof(typeName) | ((ver)<<16))
|
|
|
|
//! \ingroup nvapitypes
|
|
#define GET_NVAPI_VERSION(ver) (NvU32)((ver)>>16)
|
|
|
|
//! \ingroup nvapitypes
|
|
#define GET_NVAPI_SIZE(ver) (NvU32)((ver) & 0xffff)
|
|
|
|
|
|
// ====================================================
|
|
//! NvAPI Status Values
|
|
//! All NvAPI functions return one of these codes.
|
|
//! \ingroup nvapistatus
|
|
// ====================================================
|
|
|
|
|
|
typedef enum _NvAPI_Status
|
|
{
|
|
NVAPI_OK = 0, //!< Success. Request is completed.
|
|
NVAPI_ERROR = -1, //!< Generic error
|
|
NVAPI_LIBRARY_NOT_FOUND = -2, //!< NVAPI support library cannot be loaded.
|
|
NVAPI_NO_IMPLEMENTATION = -3, //!< not implemented in current driver installation
|
|
NVAPI_API_NOT_INITIALIZED = -4, //!< NvAPI_Initialize has not been called (successfully)
|
|
NVAPI_INVALID_ARGUMENT = -5, //!< The argument/parameter value is not valid or NULL.
|
|
NVAPI_NVIDIA_DEVICE_NOT_FOUND = -6, //!< No NVIDIA display driver, or NVIDIA GPU driving a display, was found.
|
|
NVAPI_END_ENUMERATION = -7, //!< No more items to enumerate
|
|
NVAPI_INVALID_HANDLE = -8, //!< Invalid handle
|
|
NVAPI_INCOMPATIBLE_STRUCT_VERSION = -9, //!< An argument's structure version is not supported
|
|
NVAPI_HANDLE_INVALIDATED = -10, //!< The handle is no longer valid (likely due to GPU or display re-configuration)
|
|
NVAPI_OPENGL_CONTEXT_NOT_CURRENT = -11, //!< No NVIDIA OpenGL context is current (but needs to be)
|
|
NVAPI_INVALID_POINTER = -14, //!< An invalid pointer, usually NULL, was passed as a parameter
|
|
NVAPI_NO_GL_EXPERT = -12, //!< OpenGL Expert is not supported by the current drivers
|
|
NVAPI_INSTRUMENTATION_DISABLED = -13, //!< OpenGL Expert is supported, but driver instrumentation is currently disabled
|
|
NVAPI_NO_GL_NSIGHT = -15, //!< OpenGL does not support Nsight
|
|
|
|
NVAPI_EXPECTED_LOGICAL_GPU_HANDLE = -100, //!< Expected a logical GPU handle for one or more parameters
|
|
NVAPI_EXPECTED_PHYSICAL_GPU_HANDLE = -101, //!< Expected a physical GPU handle for one or more parameters
|
|
NVAPI_EXPECTED_DISPLAY_HANDLE = -102, //!< Expected an NV display handle for one or more parameters
|
|
NVAPI_INVALID_COMBINATION = -103, //!< The combination of parameters is not valid.
|
|
NVAPI_NOT_SUPPORTED = -104, //!< Requested feature is not supported in the selected GPU
|
|
NVAPI_PORTID_NOT_FOUND = -105, //!< No port ID was found for the I2C transaction
|
|
NVAPI_EXPECTED_UNATTACHED_DISPLAY_HANDLE = -106, //!< Expected an unattached display handle as one of the input parameters.
|
|
NVAPI_INVALID_PERF_LEVEL = -107, //!< Invalid perf level
|
|
NVAPI_DEVICE_BUSY = -108, //!< Device is busy; request not fulfilled
|
|
NVAPI_NV_PERSIST_FILE_NOT_FOUND = -109, //!< NV persist file is not found
|
|
NVAPI_PERSIST_DATA_NOT_FOUND = -110, //!< NV persist data is not found
|
|
NVAPI_EXPECTED_TV_DISPLAY = -111, //!< Expected a TV output display
|
|
NVAPI_EXPECTED_TV_DISPLAY_ON_DCONNECTOR = -112, //!< Expected a TV output on the D Connector - HDTV_EIAJ4120.
|
|
NVAPI_NO_ACTIVE_SLI_TOPOLOGY = -113, //!< SLI is not active on this device.
|
|
NVAPI_SLI_RENDERING_MODE_NOTALLOWED = -114, //!< Setup of SLI rendering mode is not possible right now.
|
|
NVAPI_EXPECTED_DIGITAL_FLAT_PANEL = -115, //!< Expected a digital flat panel.
|
|
NVAPI_ARGUMENT_EXCEED_MAX_SIZE = -116, //!< Argument exceeds the expected size.
|
|
NVAPI_DEVICE_SWITCHING_NOT_ALLOWED = -117, //!< Inhibit is ON due to one of the flags in NV_GPU_DISPLAY_CHANGE_INHIBIT or SLI active.
|
|
NVAPI_TESTING_CLOCKS_NOT_SUPPORTED = -118, //!< Testing of clocks is not supported.
|
|
NVAPI_UNKNOWN_UNDERSCAN_CONFIG = -119, //!< The specified underscan config is from an unknown source (e.g. INF)
|
|
NVAPI_TIMEOUT_RECONFIGURING_GPU_TOPO = -120, //!< Timeout while reconfiguring GPUs
|
|
NVAPI_DATA_NOT_FOUND = -121, //!< Requested data was not found
|
|
NVAPI_EXPECTED_ANALOG_DISPLAY = -122, //!< Expected an analog display
|
|
NVAPI_NO_VIDLINK = -123, //!< No SLI video bridge is present
|
|
NVAPI_REQUIRES_REBOOT = -124, //!< NVAPI requires a reboot for the settings to take effect
|
|
NVAPI_INVALID_HYBRID_MODE = -125, //!< The function is not supported with the current Hybrid mode.
|
|
NVAPI_MIXED_TARGET_TYPES = -126, //!< The target types are not all the same
|
|
NVAPI_SYSWOW64_NOT_SUPPORTED = -127, //!< The function is not supported from 32-bit on a 64-bit system.
|
|
NVAPI_IMPLICIT_SET_GPU_TOPOLOGY_CHANGE_NOT_ALLOWED = -128, //!< There is no implicit GPU topology active. Use NVAPI_SetHybridMode to change topology.
|
|
NVAPI_REQUEST_USER_TO_CLOSE_NON_MIGRATABLE_APPS = -129, //!< Prompt the user to close all non-migratable applications.
|
|
NVAPI_OUT_OF_MEMORY = -130, //!< Could not allocate sufficient memory to complete the call.
|
|
NVAPI_WAS_STILL_DRAWING = -131, //!< The previous operation that is transferring information to or from this surface is incomplete.
|
|
NVAPI_FILE_NOT_FOUND = -132, //!< The file was not found.
|
|
NVAPI_TOO_MANY_UNIQUE_STATE_OBJECTS = -133, //!< There are too many unique instances of a particular type of state object.
|
|
NVAPI_INVALID_CALL = -134, //!< The method call is invalid. For example, a method's parameter may not be a valid pointer.
|
|
NVAPI_D3D10_1_LIBRARY_NOT_FOUND = -135, //!< d3d10_1.dll cannot be loaded.
|
|
NVAPI_FUNCTION_NOT_FOUND = -136, //!< Couldn't find the function in the loaded DLL.
|
|
NVAPI_INVALID_USER_PRIVILEGE = -137, //!< Current User is not Admin.
|
|
NVAPI_EXPECTED_NON_PRIMARY_DISPLAY_HANDLE = -138, //!< The handle corresponds to GDIPrimary.
|
|
NVAPI_EXPECTED_COMPUTE_GPU_HANDLE = -139, //!< Setting Physx GPU requires that the GPU is compute-capable.
|
|
NVAPI_STEREO_NOT_INITIALIZED = -140, //!< The Stereo part of NVAPI failed to initialize completely. Check if the stereo driver is installed.
|
|
NVAPI_STEREO_REGISTRY_ACCESS_FAILED = -141, //!< Access to stereo-related registry keys or values has failed.
|
|
NVAPI_STEREO_REGISTRY_PROFILE_TYPE_NOT_SUPPORTED = -142, //!< The given registry profile type is not supported.
|
|
NVAPI_STEREO_REGISTRY_VALUE_NOT_SUPPORTED = -143, //!< The given registry value is not supported.
|
|
NVAPI_STEREO_NOT_ENABLED = -144, //!< Stereo is not enabled and the function needed it to execute completely.
|
|
NVAPI_STEREO_NOT_TURNED_ON = -145, //!< Stereo is not turned on and the function needed it to execute completely.
|
|
NVAPI_STEREO_INVALID_DEVICE_INTERFACE = -146, //!< Invalid device interface.
|
|
NVAPI_STEREO_PARAMETER_OUT_OF_RANGE = -147, //!< Separation percentage or JPEG image capture quality is out of [0-100] range.
|
|
NVAPI_STEREO_FRUSTUM_ADJUST_MODE_NOT_SUPPORTED = -148, //!< The given frustum adjust mode is not supported.
|
|
NVAPI_TOPO_NOT_POSSIBLE = -149, //!< The mosaic topology is not possible given the current state of the hardware.
|
|
NVAPI_MODE_CHANGE_FAILED = -150, //!< An attempt to do a display resolution mode change has failed.
|
|
NVAPI_D3D11_LIBRARY_NOT_FOUND = -151, //!< d3d11.dll/d3d11_beta.dll cannot be loaded.
|
|
NVAPI_INVALID_ADDRESS = -152, //!< Address is outside of valid range.
|
|
NVAPI_STRING_TOO_SMALL = -153, //!< The pre-allocated string is too small to hold the result.
|
|
NVAPI_MATCHING_DEVICE_NOT_FOUND = -154, //!< The input does not match any of the available devices.
|
|
NVAPI_DRIVER_RUNNING = -155, //!< Driver is running.
|
|
NVAPI_DRIVER_NOTRUNNING = -156, //!< Driver is not running.
|
|
NVAPI_ERROR_DRIVER_RELOAD_REQUIRED = -157, //!< A driver reload is required to apply these settings.
|
|
NVAPI_SET_NOT_ALLOWED = -158, //!< Intended setting is not allowed.
|
|
NVAPI_ADVANCED_DISPLAY_TOPOLOGY_REQUIRED = -159, //!< Information can't be returned due to "advanced display topology".
|
|
NVAPI_SETTING_NOT_FOUND = -160, //!< Setting is not found.
|
|
NVAPI_SETTING_SIZE_TOO_LARGE = -161, //!< Setting size is too large.
|
|
NVAPI_TOO_MANY_SETTINGS_IN_PROFILE = -162, //!< There are too many settings for a profile.
|
|
NVAPI_PROFILE_NOT_FOUND = -163, //!< Profile is not found.
|
|
NVAPI_PROFILE_NAME_IN_USE = -164, //!< Profile name is duplicated.
|
|
NVAPI_PROFILE_NAME_EMPTY = -165, //!< Profile name is empty.
|
|
NVAPI_EXECUTABLE_NOT_FOUND = -166, //!< Application not found in the Profile.
|
|
NVAPI_EXECUTABLE_ALREADY_IN_USE = -167, //!< Application already exists in the other profile.
|
|
NVAPI_DATATYPE_MISMATCH = -168, //!< Data Type mismatch
|
|
NVAPI_PROFILE_REMOVED = -169, //!< The profile passed as parameter has been removed and is no longer valid.
|
|
NVAPI_UNREGISTERED_RESOURCE = -170, //!< An unregistered resource was passed as a parameter.
|
|
NVAPI_ID_OUT_OF_RANGE = -171, //!< The DisplayId corresponds to a display which is not within the normal outputId range.
|
|
NVAPI_DISPLAYCONFIG_VALIDATION_FAILED = -172, //!< Display topology is not valid so the driver cannot do a mode set on this configuration.
|
|
NVAPI_DPMST_CHANGED = -173, //!< Display Port Multi-Stream topology has been changed.
|
|
NVAPI_INSUFFICIENT_BUFFER = -174, //!< Input buffer is insufficient to hold the contents.
|
|
NVAPI_ACCESS_DENIED = -175, //!< No access to the caller.
|
|
NVAPI_MOSAIC_NOT_ACTIVE = -176, //!< The requested action cannot be performed without Mosaic being enabled.
|
|
NVAPI_SHARE_RESOURCE_RELOCATED = -177, //!< The surface is relocated away from video memory.
|
|
NVAPI_REQUEST_USER_TO_DISABLE_DWM = -178, //!< The user should disable DWM before calling NvAPI.
|
|
NVAPI_D3D_DEVICE_LOST = -179, //!< D3D device status is D3DERR_DEVICELOST or D3DERR_DEVICENOTRESET - the user has to reset the device.
|
|
NVAPI_INVALID_CONFIGURATION = -180, //!< The requested action cannot be performed in the current state.
|
|
NVAPI_STEREO_HANDSHAKE_NOT_DONE = -181, //!< Call failed as stereo handshake not completed.
|
|
NVAPI_EXECUTABLE_PATH_IS_AMBIGUOUS = -182, //!< The path provided was too short to determine the correct NVDRS_APPLICATION
|
|
NVAPI_DEFAULT_STEREO_PROFILE_IS_NOT_DEFINED = -183, //!< Default stereo profile is not currently defined
|
|
NVAPI_DEFAULT_STEREO_PROFILE_DOES_NOT_EXIST = -184, //!< Default stereo profile does not exist
|
|
NVAPI_CLUSTER_ALREADY_EXISTS = -185, //!< A cluster is already defined with the given configuration.
|
|
NVAPI_DPMST_DISPLAY_ID_EXPECTED = -186, //!< The input display id is not that of a multi stream enabled connector or a display device in a multi stream topology
|
|
NVAPI_INVALID_DISPLAY_ID = -187, //!< The input display id is not valid or the monitor associated to it does not support the current operation
|
|
NVAPI_STREAM_IS_OUT_OF_SYNC = -188, //!< While playing secure audio stream, stream goes out of sync
|
|
NVAPI_INCOMPATIBLE_AUDIO_DRIVER = -189, //!< Older audio driver version than required
|
|
NVAPI_VALUE_ALREADY_SET = -190, //!< Value already set, setting again not allowed.
|
|
NVAPI_TIMEOUT = -191, //!< Requested operation timed out
|
|
NVAPI_GPU_WORKSTATION_FEATURE_INCOMPLETE = -192, //!< The requested workstation feature set has incomplete driver internal allocation resources
|
|
NVAPI_STEREO_INIT_ACTIVATION_NOT_DONE = -193, //!< Call failed because InitActivation was not called.
|
|
NVAPI_SYNC_NOT_ACTIVE = -194, //!< The requested action cannot be performed without Sync being enabled.
|
|
NVAPI_SYNC_MASTER_NOT_FOUND = -195, //!< The requested action cannot be performed without Sync Master being enabled.
|
|
NVAPI_INVALID_SYNC_TOPOLOGY = -196, //!< Invalid displays passed in the NV_GSYNC_DISPLAY pointer.
|
|
NVAPI_ECID_SIGN_ALGO_UNSUPPORTED = -197, //!< The specified signing algorithm is not supported. Either an incorrect value was entered or the current installed driver/hardware does not support the input value.
|
|
NVAPI_ECID_KEY_VERIFICATION_FAILED = -198, //!< The encrypted public key verification has failed.
|
|
NVAPI_FIRMWARE_OUT_OF_DATE = -199, //!< The device's firmware is out of date.
|
|
NVAPI_FIRMWARE_REVISION_NOT_SUPPORTED = -200, //!< The device's firmware is not supported.
|
|
NVAPI_LICENSE_CALLER_AUTHENTICATION_FAILED = -201, //!< The caller is not authorized to modify the License.
|
|
NVAPI_D3D_DEVICE_NOT_REGISTERED = -202, //!< The user tried to use a deferred context without registering the device first
|
|
NVAPI_RESOURCE_NOT_ACQUIRED = -203, //!< Head or SourceId was not reserved for the VR Display before doing the Modeset.
|
|
NVAPI_TIMING_NOT_SUPPORTED = -204, //!< Provided timing is not supported.
|
|
NVAPI_HDCP_ENCRYPTION_FAILED = -205, //!< HDCP Encryption Failed for the device. Would be applicable when the device is HDCP Capable.
|
|
NVAPI_PCLK_LIMITATION_FAILED = -206, //!< Provided mode is over sink device pclk limitation.
|
|
NVAPI_NO_CONNECTOR_FOUND = -207, //!< No connector on GPU found.
|
|
} NvAPI_Status;
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// FUNCTION NAME: NvAPI_SYS_GetDriverAndBranchVersion
|
|
//
|
|
//! DESCRIPTION: This API returns display driver version and driver-branch string.
|
|
//!
|
|
//! SUPPORTED OS: Windows XP and higher
|
|
//!
|
|
//!
|
|
//! \param [out] pDriverVersion Contains the driver version after successful return.
|
|
//! \param [out] szBuildBranchString Contains the driver-branch string after successful return.
|
|
//!
|
|
//! \retval ::NVAPI_INVALID_ARGUMENT: either pDriverVersion is NULL or enum index too big
|
|
//! \retval ::NVAPI_OK - completed request
|
|
//! \retval ::NVAPI_API_NOT_INTIALIZED - NVAPI not initialized
|
|
//! \retval ::NVAPI_ERROR - miscellaneous error occurred
|
|
//!
|
|
//! \ingroup driverapi
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
NVAPI_INTERFACE NvAPI_SYS_GetDriverAndBranchVersion(NvU32* pDriverVersion, NvAPI_ShortString szBuildBranchString);
|
|
//! \ingroup driverapi
|
|
//! Used in NvAPI_GPU_GetMemoryInfo().
|
|
typedef struct
|
|
{
|
|
NvU32 version; //!< Version info
|
|
NvU32 dedicatedVideoMemory; //!< Size(in kb) of the physical framebuffer.
|
|
NvU32 availableDedicatedVideoMemory; //!< Size(in kb) of the available physical framebuffer for allocating video memory surfaces.
|
|
NvU32 systemVideoMemory; //!< Size(in kb) of system memory the driver allocates at load time.
|
|
NvU32 sharedSystemMemory; //!< Size(in kb) of shared system memory that driver is allowed to commit for surfaces across all allocations.
|
|
|
|
} NV_DISPLAY_DRIVER_MEMORY_INFO_V1;
|
|
|
|
|
|
//! \ingroup driverapi
|
|
//! Used in NvAPI_GPU_GetMemoryInfo().
|
|
typedef struct
|
|
{
|
|
NvU32 version; //!< Version info
|
|
NvU32 dedicatedVideoMemory; //!< Size(in kb) of the physical framebuffer.
|
|
NvU32 availableDedicatedVideoMemory; //!< Size(in kb) of the available physical framebuffer for allocating video memory surfaces.
|
|
NvU32 systemVideoMemory; //!< Size(in kb) of system memory the driver allocates at load time.
|
|
NvU32 sharedSystemMemory; //!< Size(in kb) of shared system memory that driver is allowed to commit for surfaces across all allocations.
|
|
NvU32 curAvailableDedicatedVideoMemory; //!< Size(in kb) of the current available physical framebuffer for allocating video memory surfaces.
|
|
|
|
} NV_DISPLAY_DRIVER_MEMORY_INFO_V2;
|
|
|
|
//! \ingroup driverapi
|
|
//! Used in NvAPI_GPU_GetMemoryInfo().
|
|
typedef struct
|
|
{
|
|
NvU32 version; //!< Version info
|
|
NvU32 dedicatedVideoMemory; //!< Size(in kb) of the physical framebuffer.
|
|
NvU32 availableDedicatedVideoMemory; //!< Size(in kb) of the available physical framebuffer for allocating video memory surfaces.
|
|
NvU32 systemVideoMemory; //!< Size(in kb) of system memory the driver allocates at load time.
|
|
NvU32 sharedSystemMemory; //!< Size(in kb) of shared system memory that driver is allowed to commit for surfaces across all allocations.
|
|
NvU32 curAvailableDedicatedVideoMemory; //!< Size(in kb) of the current available physical framebuffer for allocating video memory surfaces.
|
|
NvU32 dedicatedVideoMemoryEvictionsSize; //!< Size(in kb) of the total size of memory released as a result of the evictions.
|
|
NvU32 dedicatedVideoMemoryEvictionCount; //!< Indicates the number of eviction events that caused an allocation to be removed from dedicated video memory to free GPU
|
|
//!< video memory to make room for other allocations.
|
|
} NV_DISPLAY_DRIVER_MEMORY_INFO_V3;
|
|
|
|
//! \ingroup driverapi
|
|
typedef NV_DISPLAY_DRIVER_MEMORY_INFO_V3 NV_DISPLAY_DRIVER_MEMORY_INFO;
|
|
|
|
//! \ingroup driverapi
|
|
//! Macro for constructing the version field of NV_DISPLAY_DRIVER_MEMORY_INFO_V1
|
|
#define NV_DISPLAY_DRIVER_MEMORY_INFO_VER_1 MAKE_NVAPI_VERSION(NV_DISPLAY_DRIVER_MEMORY_INFO_V1,1)
|
|
|
|
//! \ingroup driverapi
|
|
//! Macro for constructing the version field of NV_DISPLAY_DRIVER_MEMORY_INFO_V2
|
|
#define NV_DISPLAY_DRIVER_MEMORY_INFO_VER_2 MAKE_NVAPI_VERSION(NV_DISPLAY_DRIVER_MEMORY_INFO_V2,2)
|
|
|
|
//! \ingroup driverapi
|
|
//! Macro for constructing the version field of NV_DISPLAY_DRIVER_MEMORY_INFO_V3
|
|
#define NV_DISPLAY_DRIVER_MEMORY_INFO_VER_3 MAKE_NVAPI_VERSION(NV_DISPLAY_DRIVER_MEMORY_INFO_V3,3)
|
|
|
|
//! \ingroup driverapi
|
|
#define NV_DISPLAY_DRIVER_MEMORY_INFO_VER NV_DISPLAY_DRIVER_MEMORY_INFO_VER_3
|
|
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// FUNCTION NAME: NvAPI_GPU_GetMemoryInfo
|
|
//
|
|
//! DESCRIPTION: This function retrieves the available driver memory footprint for the specified GPU.
|
|
//!
|
|
//! SUPPORTED OS: Windows XP and higher
|
|
//!
|
|
//!
|
|
//! TCC_SUPPORTED
|
|
//!
|
|
//! \since Release: 177
|
|
//!
|
|
//! \param [in] hPhysicalGpu Handle of the physical GPU for which the memory information is to be extracted.
|
|
//! \param [out] pMemoryInfo The memory footprint available in the driver. See NV_DISPLAY_DRIVER_MEMORY_INFO.
|
|
//!
|
|
//! \retval NVAPI_INVALID_ARGUMENT pMemoryInfo is NULL.
|
|
//! \retval NVAPI_OK Call successful.
|
|
//! \retval NVAPI_NVIDIA_DEVICE_NOT_FOUND No NVIDIA GPU driving a display was found.
|
|
//! \retval NVAPI_INCOMPATIBLE_STRUCT_VERSION NV_DISPLAY_DRIVER_MEMORY_INFO structure version mismatch.
|
|
//!
|
|
//! \ingroup driverapi
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
NVAPI_INTERFACE NvAPI_GPU_GetMemoryInfo(NvPhysicalGpuHandle hPhysicalGpu, NV_DISPLAY_DRIVER_MEMORY_INFO *pMemoryInfo);
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// FUNCTION NAME: NvAPI_EnumPhysicalGPUs
|
|
//
|
|
//! This function returns an array of physical GPU handles.
|
|
//! Each handle represents a physical GPU present in the system.
|
|
//! That GPU may be part of an SLI configuration, or may not be visible to the OS directly.
|
|
//!
|
|
//! At least one GPU must be present in the system and running an NVIDIA display driver.
|
|
//!
|
|
//! The array nvGPUHandle will be filled with physical GPU handle values. The returned
|
|
//! gpuCount determines how many entries in the array are valid.
|
|
//!
|
|
//! \note In drivers older than 105.00, all physical GPU handles get invalidated on a
|
|
//! modeset. So the calling applications need to renum the handles after every modeset.\n
|
|
//! With drivers 105.00 and up, all physical GPU handles are constant.
|
|
//! Physical GPU handles are constant as long as the GPUs are not physically moved and
|
|
//! the SBIOS VGA order is unchanged.
|
|
//!
|
|
//! For GPU handles in TCC MODE please use NvAPI_EnumTCCPhysicalGPUs()
|
|
//!
|
|
//! SUPPORTED OS: Windows XP and higher, Mac OS X
|
|
//!
|
|
//!
|
|
//! \par Introduced in
|
|
//! \since Release: 80
|
|
//!
|
|
//! \retval NVAPI_INVALID_ARGUMENT nvGPUHandle or pGpuCount is NULL
|
|
//! \retval NVAPI_OK One or more handles were returned
|
|
//! \retval NVAPI_NVIDIA_DEVICE_NOT_FOUND No NVIDIA GPU driving a display was found
|
|
//! \ingroup gpu
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
NVAPI_INTERFACE NvAPI_EnumPhysicalGPUs(NvPhysicalGpuHandle nvGPUHandle[NVAPI_MAX_PHYSICAL_GPUS], NvU32 *pGpuCount);
|
|
#if defined(_D3D9_H_) || defined(__d3d10_h__) || defined(__d3d11_h__)
|
|
|
|
NV_DECLARE_HANDLE(NVDX_ObjectHandle); // DX Objects
|
|
static const NVDX_ObjectHandle NVDX_OBJECT_NONE = 0;
|
|
|
|
#endif //if defined(_D3D9_H_) || defined(__d3d10_h__) || defined(__d3d11_h__)
|
|
#if defined(_D3D9_H_) || defined(__d3d10_h__) || defined(__d3d11_h__)
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// FUNCTION NAME: NvAPI_D3D_GetObjectHandleForResource
|
|
//
|
|
//! DESCRIPTION: This API gets a handle to a resource.
|
|
//!
|
|
//! \param [in] pDev The ID3D11Device, ID3D10Device or IDirect3DDevice9 to use
|
|
//! \param [in] pResource The ID3D10Resource, ID3D10Resource or IDirect3DResource9 from which
|
|
//! we want the NvAPI handle
|
|
//! \param [out] pHandle A handle to the resource
|
|
//!
|
|
//! SUPPORTED OS: Windows XP and higher
|
|
//!
|
|
//!
|
|
//! \since Release: 185
|
|
//!
|
|
//! \return ::NVAPI_OK if the handle was populated.
|
|
//!
|
|
//! \ingroup dx
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
NVAPI_INTERFACE NvAPI_D3D_GetObjectHandleForResource(
|
|
IUnknown *pDevice,
|
|
IUnknown *pResource,
|
|
NVDX_ObjectHandle *pHandle);
|
|
|
|
|
|
#endif //if defined(_D3D9_H_) || defined(__d3d10_h__) || defined(__d3d11_h__)
|
|
|
|
#include"nvapi_lite_salend.h"
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#pragma pack(pop)
|