[PR #1263] fallback to software rendering #24554

Open
opened 2026-01-31 09:03:58 +00:00 by claunia · 0 comments
Owner

Original Pull Request: https://github.com/microsoft/terminal/pull/1263

State: closed
Merged: Yes


Summary of the Pull Request

This PR enables a software rendering fallback for the DX renderer in the case that hardware acceleration fails. This is primarily useful for Hyper-V environments where hardware acceleration is not guaranteed to exist.

References

This will be useful for future work to enable the DX renderer to run on windows 7 since win7 virtual machines do not/cannot have hardware acceleration unlike windows 10 machines

PR Checklist

  • Closes #xxx

  • CLA signed. If not, go over here and sign the CLA

  • Tests added/passed

  • Requires documentation to be updated

  • I've discussed this with core contributors already. If not checked, I'm ready to accept this work might be rejected in favor of a different grand plan. Issue number where discussion took place: #xxx

Detailed Description of the Pull Request / Additional comments

The PR does two things:

  • Fallback to D3D_DRIVER_TYPE_WARP if D3D_DRIVER_TYPE_HARDWARE fails.
  • pass NULL as the adapter instead of creating the default adapter ourselves.

Validation Steps Performed

I ran this as part of a larger codechange to enable win7 support. The software fallback worked correctly on win7.

**Original Pull Request:** https://github.com/microsoft/terminal/pull/1263 **State:** closed **Merged:** Yes --- <!-- Enter a brief description/summary of your PR here. What does it fix/what does it change/how was it tested (even manually, if necessary)? --> ## Summary of the Pull Request This PR enables a software rendering fallback for the DX renderer in the case that hardware acceleration fails. This is primarily useful for Hyper-V environments where hardware acceleration is not guaranteed to exist. <!-- Other than the issue solved, is this relevant to any other issues/existing PRs? --> ## References This will be useful for future work to enable the DX renderer to run on windows 7 since win7 virtual machines do not/cannot have hardware acceleration unlike windows 10 machines <!-- Please review the items on the PR checklist before submitting--> ## PR Checklist * [ ] Closes #xxx * [x] CLA signed. If not, go over [here](https://cla.opensource.microsoft.com/microsoft/Terminal) and sign the CLA * [ ] Tests added/passed * [ ] Requires documentation to be updated * [ ] I've discussed this with core contributors already. If not checked, I'm ready to accept this work might be rejected in favor of a different grand plan. Issue number where discussion took place: #xxx <!-- Provide a more detailed description of the PR, other things fixed or any additional comments/features here --> ## Detailed Description of the Pull Request / Additional comments The PR does two things: - Fallback to `D3D_DRIVER_TYPE_WARP` if `D3D_DRIVER_TYPE_HARDWARE` fails. - pass `NULL` as the adapter instead of creating the default adapter ourselves. <!-- Describe how you validated the behavior. Add automated tests wherever possible, but list manual validation steps taken as well --> ## Validation Steps Performed I ran this as part of a larger codechange to enable win7 support. The software fallback worked correctly on win7.
claunia added the pull-request label 2026-01-31 09:03:58 +00:00
Sign in to join this conversation.
No Label pull-request
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#24554