Holographic Remoting troubleshooting

Note

This guidance is specific to Holographic Remoting on HoloLens 2 and Windows PCs running Windows Mixed Reality.

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 you want to use the 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
  • 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