aboutsummaryrefslogtreecommitdiff
path: root/external/nvapi/include/nvapi_lite_stereo.h
diff options
context:
space:
mode:
authorMiles Macklin <[email protected]>2017-03-10 14:51:31 +1300
committerMiles Macklin <[email protected]>2017-03-10 14:51:31 +1300
commitad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f (patch)
tree4cc6f3288363889d7342f7f8407c0251e6904819 /external/nvapi/include/nvapi_lite_stereo.h
downloadflex-ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f.tar.xz
flex-ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f.zip
Initial 1.1.0 binary release
Diffstat (limited to 'external/nvapi/include/nvapi_lite_stereo.h')
-rw-r--r--external/nvapi/include/nvapi_lite_stereo.h600
1 files changed, 600 insertions, 0 deletions
diff --git a/external/nvapi/include/nvapi_lite_stereo.h b/external/nvapi/include/nvapi_lite_stereo.h
new file mode 100644
index 0000000..4747e8d
--- /dev/null
+++ b/external/nvapi/include/nvapi_lite_stereo.h
@@ -0,0 +1,600 @@
+ /************************************************************************************************************************************\
+|* *|
+|* 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"
+#include"nvapi_lite_common.h"
+#pragma pack(push,8)
+#ifdef __cplusplus
+extern "C" {
+#endif
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_Enable
+//
+//! DESCRIPTION: This APU enables stereo mode in the registry.
+//! Calls to this function affect the entire system.
+//! If stereo is not enabled, then calls to functions that require that stereo is enabled have no effect,
+//! and will return the appropriate error code.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \retval ::NVAPI_OK Stereo is now enabled.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_Enable(void);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_Disable
+//
+//! DESCRIPTION: This API disables stereo mode in the registry.
+//! Calls to this function affect the entire system.
+//! If stereo is not enabled, then calls to functions that require that stereo is enabled have no effect,
+//! and will return the appropriate error code.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \retval ::NVAPI_OK Stereo is now disabled.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_Disable(void);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_IsEnabled
+//
+//! DESCRIPTION: This API checks if stereo mode is enabled in the registry.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [out] pIsStereoEnabled Address where the result of the inquiry will be placed.
+//!
+//! \retval ::NVAPI_OK Check was sucessfully completed and result reflects current state of stereo availability.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_IsEnabled(NvU8 *pIsStereoEnabled);
+#if defined(_D3D9_H_) || defined(__d3d10_h__) || defined(__d3d11_h__)
+
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_CreateHandleFromIUnknown
+//
+//! DESCRIPTION: This API creates a stereo handle that is used in subsequent calls related to a given device interface.
+//! This must be called before any other NvAPI_Stereo_ function for that handle.
+//! Multiple devices can be used at one time using multiple calls to this function (one per each device).
+//!
+//! HOW TO USE: After the Direct3D device is created, create the stereo handle.
+//! On call success:
+//! -# Use all other NvAPI_Stereo_ functions that have stereo handle as first parameter.
+//! -# After the device interface that corresponds to the the stereo handle is destroyed,
+//! the application should call NvAPI_DestroyStereoHandle() for that stereo handle.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] pDevice Pointer to IUnknown interface that is IDirect3DDevice9* in DX9, ID3D10Device*.
+//! \param [out] pStereoHandle Pointer to the newly created stereo handle.
+//!
+//! \retval ::NVAPI_OK Stereo handle is created for given device interface.
+//! \retval ::NVAPI_INVALID_ARGUMENT Provided device interface is invalid.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_CreateHandleFromIUnknown(IUnknown *pDevice, StereoHandle *pStereoHandle);
+
+#endif // defined(_D3D9_H_) || defined(__d3d10_h__)
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_DestroyHandle
+//
+//! DESCRIPTION: This API destroys the stereo handle created with one of the NvAPI_Stereo_CreateHandleFrom() functions.
+//! This should be called after the device corresponding to the handle has been destroyed.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that is to be destroyed.
+//!
+//! \retval ::NVAPI_OK Stereo handle is destroyed.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_DestroyHandle(StereoHandle stereoHandle);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_Activate
+//
+//! DESCRIPTION: This API activates stereo for the device interface corresponding to the given stereo handle.
+//! Activating stereo is possible only if stereo was enabled previously in the registry.
+//! If stereo is not activated, then calls to functions that require that stereo is activated have no effect,
+//! and will return the appropriate error code.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle corresponding to the device interface.
+//!
+//! \retval ::NVAPI_OK Stereo is turned on.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_Activate(StereoHandle stereoHandle);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_Deactivate
+//
+//! DESCRIPTION: This API deactivates stereo for the given device interface.
+//! If stereo is not activated, then calls to functions that require that stereo is activated have no effect,
+//! and will return the appropriate error code.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//!
+//! \retval ::NVAPI_OK Stereo is turned off.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_Deactivate(StereoHandle stereoHandle);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_IsActivated
+//
+//! DESCRIPTION: This API checks if stereo is activated for the given device interface.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [in] pIsStereoOn Address where result of the inquiry will be placed.
+//!
+//! \retval ::NVAPI_OK - Check was sucessfully completed and result reflects current state of stereo (on/off).
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE - Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED - NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED - Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR - Something is wrong (generic error).
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_IsActivated(StereoHandle stereoHandle, NvU8 *pIsStereoOn);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_GetSeparation
+//
+//! DESCRIPTION: This API gets current separation value (in percents).
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [out] pSeparationPercentage Address of @c float type variable to store current separation percentage in.
+//!
+//! \retval ::NVAPI_OK Retrieval of separation percentage was successfull.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_GetSeparation(StereoHandle stereoHandle, float *pSeparationPercentage);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_SetSeparation
+//
+//! DESCRIPTION: This API sets separation to given percentage.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [in] newSeparationPercentage New value for separation percentage.
+//!
+//! \retval ::NVAPI_OK Setting of separation percentage was successfull.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_PARAMETER_OUT_OF_RANGE Given separation percentage is out of [0..100] range.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_SetSeparation(StereoHandle stereoHandle, float newSeparationPercentage);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_GetConvergence
+//
+//! DESCRIPTION: This API gets the current convergence value.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [out] pConvergence Address of @c float type variable to store current convergence value in.
+//!
+//! \retval ::NVAPI_OK Retrieval of convergence value was successfull.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_GetConvergence(StereoHandle stereoHandle, float *pConvergence);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_SetConvergence
+//
+//! DESCRIPTION: This API sets convergence to the given value.
+//!
+//! WHEN TO USE: After the stereo handle for the device interface is created via successfull call to the appropriate NvAPI_Stereo_CreateHandleFrom() function.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \since Release: 180
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [in] newConvergence New value for convergence.
+//!
+//! \retval ::NVAPI_OK Setting of convergence value was successfull.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_SetConvergence(StereoHandle stereoHandle, float newConvergence);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_SetActiveEye
+//
+//! \fn NvAPI_Stereo_SetActiveEye(StereoHandle hStereoHandle, NV_STEREO_ACTIVE_EYE StereoEye);
+//! DESCRIPTION: This API sets the back buffer to left or right in Direct stereo mode.
+//!
+//! HOW TO USE: After the stereo handle for device interface is created via successfull call to appropriate
+//! NvAPI_Stereo_CreateHandleFrom function.
+//!
+//! \since Release: 285
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [in] StereoEye Defines active eye in Direct stereo mode
+//!
+//! \retval ::NVAPI_OK - Active eye is set.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE - Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED - NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED - Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_INVALID_ARGUMENT - StereoEye parameter has not allowed value.
+//! \retval ::NVAPI_SET_NOT_ALLOWED - Current stereo mode is not Direct
+//! \retval ::NVAPI_ERROR - Something is wrong (generic error).
+//
+///////////////////////////////////////////////////////////////////////////////
+
+//! \ingroup stereoapi
+typedef enum _NV_StereoActiveEye
+{
+ NVAPI_STEREO_EYE_RIGHT = 1,
+ NVAPI_STEREO_EYE_LEFT = 2,
+ NVAPI_STEREO_EYE_MONO = 3,
+} NV_STEREO_ACTIVE_EYE;
+
+//! \ingroup stereoapi
+NVAPI_INTERFACE NvAPI_Stereo_SetActiveEye(StereoHandle hStereoHandle, NV_STEREO_ACTIVE_EYE StereoEye);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_SetDriverMode
+//
+//! \fn NvAPI_Stereo_SetDriverMode( NV_STEREO_DRIVER_MODE mode );
+//! DESCRIPTION: This API sets the 3D stereo driver mode: Direct or Automatic
+//!
+//! HOW TO USE: This API must be called before the device is created.
+//! Applies to DirectX 9 and higher.
+//!
+//! \since Release: 285
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \param [in] mode Defines the 3D stereo driver mode: Direct or Automatic
+//!
+//! \retval ::NVAPI_OK Active eye is set.
+//! \retval ::NVAPI_API_NOT_INTIALIZED NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_INVALID_ARGUMENT mode parameter has not allowed value.
+//! \retval ::NVAPI_ERROR Something is wrong (generic error).
+//
+///////////////////////////////////////////////////////////////////////////////
+
+//! \ingroup stereoapi
+typedef enum _NV_StereoDriverMode
+{
+ NVAPI_STEREO_DRIVER_MODE_AUTOMATIC = 0,
+ NVAPI_STEREO_DRIVER_MODE_DIRECT = 2,
+} NV_STEREO_DRIVER_MODE;
+
+//! \ingroup stereoapi
+NVAPI_INTERFACE NvAPI_Stereo_SetDriverMode( NV_STEREO_DRIVER_MODE mode );
+
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_GetEyeSeparation
+//
+//! DESCRIPTION: This API returns eye separation as a ratio of <between eye distance>/<physical screen width>.
+//!
+//! HOW TO USE: After the stereo handle for device interface is created via successfull call to appropriate API. Applies only to DirectX 9 and up.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \param [in] stereoHandle Stereo handle that corresponds to the device interface.
+//! \param [out] pSeparation Eye separation.
+//!
+//! \retval ::NVAPI_OK Active eye is set.
+//! \retval ::NVAPI_STEREO_INVALID_DEVICE_INTERFACE Device interface is not valid. Create again, then attach again.
+//! \retval ::NVAPI_API_NOT_INTIALIZED NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR (generic error).
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_GetEyeSeparation(StereoHandle hStereoHandle, float *pSeparation );
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_IsWindowedModeSupported
+//
+//! DESCRIPTION: This API returns availability of windowed mode stereo
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! \param [out] bSupported(OUT) != 0 - supported, \n
+//! == 0 - is not supported
+//!
+//!
+//! \retval ::NVAPI_OK Retrieval of frustum adjust mode was successfull.
+//! \retval ::NVAPI_API_NOT_INTIALIZED NVAPI not initialized.
+//! \retval ::NVAPI_STEREO_NOT_INITIALIZED Stereo part of NVAPI not initialized.
+//! \retval ::NVAPI_ERROR Something is wrong (generic error).
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_IsWindowedModeSupported(NvU8* bSupported);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_SetSurfaceCreationMode
+//
+//! \function NvAPI_Stereo_SetSurfaceCreationMode(StereoHandle hStereoHandle, NVAPI_STEREO_SURFACECREATEMODE creationMode)
+//! \param [in] hStereoHandle Stereo handle that corresponds to the device interface.
+//! \param [in] creationMode New surface creation mode for this device interface.
+//!
+//! \since Release: 285
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! DESCRIPTION: This API sets surface creation mode for this device interface.
+//!
+//! WHEN TO USE: After the stereo handle for device interface is created via successful call to appropriate NvAPI_Stereo_CreateHandleFrom function.
+//!
+//! \return This API can return any of the error codes enumerated in #NvAPI_Status.
+//! There are no return error codes with specific meaning for this API.
+//!
+///////////////////////////////////////////////////////////////////////////////
+
+//! \ingroup stereoapi
+typedef enum _NVAPI_STEREO_SURFACECREATEMODE
+{
+ NVAPI_STEREO_SURFACECREATEMODE_AUTO, //!< Use driver registry profile settings for surface creation mode.
+ NVAPI_STEREO_SURFACECREATEMODE_FORCESTEREO, //!< Always create stereo surfaces.
+ NVAPI_STEREO_SURFACECREATEMODE_FORCEMONO //!< Always create mono surfaces.
+} NVAPI_STEREO_SURFACECREATEMODE;
+
+//! \ingroup stereoapi
+NVAPI_INTERFACE NvAPI_Stereo_SetSurfaceCreationMode(__in StereoHandle hStereoHandle, __in NVAPI_STEREO_SURFACECREATEMODE creationMode);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_GetSurfaceCreationMode
+//
+//! \function NvAPI_Stereo_GetSurfaceCreationMode(StereoHandle hStereoHandle, NVAPI_STEREO_SURFACECREATEMODE* pCreationMode)
+//! \param [in] hStereoHandle Stereo handle that corresponds to the device interface.
+//! \param [out] pCreationMode The current creation mode for this device interface.
+//!
+//! \since Release: 295
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! DESCRIPTION: This API gets surface creation mode for this device interface.
+//!
+//! WHEN TO USE: After the stereo handle for device interface is created via successful call to appropriate NvAPI_Stereo_CreateHandleFrom function.
+//!
+//! \return This API can return any of the error codes enumerated in #NvAPI_Status.
+//! There are no return error codes with specific meaning for this API.
+//!
+///////////////////////////////////////////////////////////////////////////////
+
+//! \ingroup stereoapi
+NVAPI_INTERFACE NvAPI_Stereo_GetSurfaceCreationMode(__in StereoHandle hStereoHandle, __in NVAPI_STEREO_SURFACECREATEMODE* pCreationMode);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_Debug_WasLastDrawStereoized
+//
+//! \param [in] hStereoHandle Stereo handle that corresponds to the device interface.
+//! \param [out] pWasStereoized Address where result of the inquiry will be placed.
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! DESCRIPTION: This API checks if the last draw call was stereoized. It is a very expensive to call and should be used for debugging purpose *only*.
+//!
+//! WHEN TO USE: After the stereo handle for device interface is created via successful call to appropriate NvAPI_Stereo_CreateHandleFrom function.
+//!
+//! \return This API can return any of the error codes enumerated in #NvAPI_Status.
+//! There are no return error codes with specific meaning for this API.
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_Debug_WasLastDrawStereoized(__in StereoHandle hStereoHandle, __out NvU8 *pWasStereoized);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_SetDefaultProfile
+//
+//!
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! DESCRIPTION: This API defines the stereo profile used by the driver in case the application has no associated profile.
+//!
+//! WHEN TO USE: To take effect, this API must be called before D3D device is created. Calling once a device has been created will not affect the current device.
+//!
+//! \param [in] szProfileName Default profile name.
+//!
+//! \return This API can return any of the error codes enumerated in #NvAPI_Status.
+//! Error codes specific to this API are described below.
+//!
+//! \retval NVAPI_SUCCESS - Default stereo profile name has been copied into szProfileName.
+//! \retval NVAPI_INVALID_ARGUMENT - szProfileName == NULL.
+//! \retval NVAPI_DEFAULT_STEREO_PROFILE_DOES_NOT_EXIST - Default stereo profile does not exist
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_SetDefaultProfile(__in const char* szProfileName);
+///////////////////////////////////////////////////////////////////////////////
+//
+// FUNCTION NAME: NvAPI_Stereo_GetDefaultProfile
+//
+//! SUPPORTED OS: Windows Vista and higher
+//!
+//!
+//! DESCRIPTION: This API retrieves the current default stereo profile.
+//!
+//! After call cbSizeOut contain 0 if default profile is not set required buffer size cbSizeOut.
+//! To get needed buffer size this function can be called with szProfileName==0 and cbSizeIn == 0.
+//!
+//! WHEN TO USE: This API can be called at any time.
+//!
+//!
+//! \param [in] cbSizeIn Size of buffer allocated for default stereo profile name.
+//! \param [out] szProfileName Default stereo profile name.
+//! \param [out] pcbSizeOut Required buffer size.
+//! # ==0 - there is no default stereo profile name currently set
+//! # !=0 - size of buffer required for currently set default stereo profile name including trailing '0'.
+//!
+//!
+//! \return This API can return any of the error codes enumerated in #NvAPI_Status.
+//! Error codes specific to this API are described below.
+//!
+//! \retval NVAPI_SUCCESS - Default stereo profile name has been copied into szProfileName.
+//! \retval NVAPI_DEFAULT_STEREO_PROFILE_IS_NOT_DEFINED - There is no default stereo profile set at this time.
+//! \retval NVAPI_INVALID_ARGUMENT - pcbSizeOut == 0 or cbSizeIn >= *pcbSizeOut && szProfileName == 0
+//! \retval NVAPI_INSUFFICIENT_BUFFER - cbSizeIn < *pcbSizeOut
+//!
+//! \ingroup stereoapi
+///////////////////////////////////////////////////////////////////////////////
+NVAPI_INTERFACE NvAPI_Stereo_GetDefaultProfile( __in NvU32 cbSizeIn, __out_bcount_part_opt(cbSizeIn, *pcbSizeOut) char* szProfileName, __out NvU32 *pcbSizeOut);
+
+#include"nvapi_lite_salend.h"
+#ifdef __cplusplus
+}
+#endif
+#pragma pack(pop)