holographic-remoting-troubleshooting.md

title	description	author	ms.author	ms.date	ms.topic	keywords
Holographic Remoting troubleshooting and limitations	Find troubleshooting resources and instructions for the Holographic Remoting feature on HoloLens 2 devices.	florianbagarmicrosoft	flbagar	12/01/2020	article	Windows Mixed Reality, holograms, holographic remoting, remote rendering, network rendering, HoloLens, remote holograms, troubleshoot, help, mixed reality headset, windows mixed reality headset, virtual reality headset

Holographic Remoting troubleshooting

Important

This guidance is specific to Holographic Remoting on HoloLens 2.

Spectre mitigated libraries not found.

Holographic Remoting sample apps have Spectre mitigation (/Qspectre) enabled in Release configuration.

If you get the vccorlib.lib cannot be opened fatal error, make sure that your Visual Studio Workload includes the Spectre mitigated libraries

Speech

The Holographic Remoting Player supports a diagnostics overlay, which can be enabled by saying Enable Diagnostics and disabled by saying Disable Diagnostics. If you have trouble with these voice commands, you can also launch the Holographic Remoting player via a web browser using ms-holographic-remoting:?stats as a URL.

H265 video codec not available

Install the HEVC Video Extensions when using H265 video codec in your remote app. If you run into issues where the codec is installed but can't be used, check out troubleshooting guide.

Limitations

The following APIs are currently not supported when using Holographic Remoting for HoloLens 2 and will raise an ERROR_NOT_SUPPORTED error unless otherwise stated:

Windows.Graphics.Holographic

• HolographicCamera.ViewConfiguration
  • Supported starting with version 2.0.18
  • On previous versions always raise an error.
• HolographicCamera.IsHardwareContentProtectionEnabled
• HolographicViewConfiguration.RequestRenderTargetSize
  • Supported starting with version 2.2.0
  • On previous versions don't fail, but the render target size won't be changed.
• HolographicCameraPose.OverrideProjectionTransform
• HolographicCameraPose.OverrideViewport
• HolographicCameraPose.OverrideViewTransform
  • Supported starting with version 2.2.0
• HolographicCameraRenderingParameters.CommitDirect3D11DepthBuffer
  • Doe.
  • Supported starting with version 2.1.0
• HolographicDisplay.TryGetViewConfiguration
  • Querying HolographicViewConfigurationKind.PhotoVideoCamera will always return a nullptr.
  • Supported starting with version 2.0.18
  • On previous versions always raise an error.
• HolographicSpace.CreateFramePresentationMonitor
• HolographicDisplay.GetDefault
  • Will report an error if called before a connection was established.

Windows.Perception.Spatial

• SpatialLocation.AbsoluteAngularAcceleration
• SpatialLocation.AbsoluteAngularAccelerationAxisAngle
• SpatialLocation.AbsoluteAngularVelocity
• SpatialLocation.AbsoluteAngularVelocityAxisAngle
• SpatialLocation.AbsoluteLinearAcceleration
• SpatialLocation.AbsoluteLinearVelocity
• SpatialStageFrameOfReference.Current
  • Supported starting with version 2.2.0
  • On previous versions always return nullptr.
• SpatialStageFrameOfReference.RequestNewStageAsync
  • Supported starting with version 2.2.0
• SpatialAnchor.RemovedByUser
• SpatialAnchorExporter.GetDefault
  • Supported starting with version 2.0.9.
  • On previous versions always return nullptr.
• SpatialAnchorExporter.RequestAccessAsync
  • Supported starting with version 2.0.9.
  • On previous versions the async operation always completed with SpatialPerceptionAccessStatus.DeniedBySystem.
• SpatialAnchorTransferManager.RequestAccessAsync
  • Async operation always completes with SpatialPerceptionAccessStatus.DeniedBySystem.
• SpatialAnchorTransferManager.TryExportAnchorsAsync
  • Async operation always completes with false.
• SpatialAnchorTransferManager.TryImportAnchorsAsync
  • Async operation always completes with nullptr.

Windows.UI.Input.Spatial

• SpatialInteractionSource.TryCreateHandMeshObserver
• SpatialInteractionSource.TryCreateHandMeshObserverAsync
• SpatialInteractionSource.Controller
  • Supported starting with version 2.2.0

Windows.Perception.Spatial.Preview

• SpatialGraphInteropPreview.CreateLocatorForNode
• SpatialGraphInteropPreview.TryCreateFrameOfReference

See Also

• Holographic Remoting overview
• Holographic Remoting Version History
• Writing a Holographic Remoting remote app using Windows Mixed Reality APIs
• Writing a Holographic Remoting remote app using OpenXR APIs
• Writing a custom Holographic Remoting player app
• Holographic Remoting software license terms
• Microsoft Privacy Statement