| Previous | Next |
| D3D11_ERROR_DEFERRED_CONTEXT_MAP_WITHOUT_INITIAL_DISCARD | D3D12_ERROR_DRIVER_VERSION_MISMATCH |
D3D12_ERROR_ADAPTER_NOT_FOUND
What Windows rejected: adapter not found
Windows reports D3D12_ERROR_ADAPTER_NOT_FOUND (0x887E0001) at the d3d checkpoint. Here, a cached PSO or pipeline-library blob belongs to a different graphics adapter. That narrows the first investigation to cached Direct3D 12 pipeline state identity instead of the entire GPU stack.
Build a useful diagnostic record
| Capture item | Why it matters |
|---|---|
| Object identity | cached Direct3D 12 pipeline state identity |
| Rejected condition | a cached PSO or pipeline-library blob belongs to a different graphics adapter |
| What to capture | adapter LUID, vendor/device/subsystem IDs, cache header, pipeline-library version and current device identity |
| Current graph state | Direct3D device plus the descriptor, resource or cached pipeline object supplied by the application |
| Supporting trace | Direct3D debug-layer output, object creation stacks, normalized descriptors, feature level and adapter/driver identity |
Separate state from capability
- Capture the failing state. Record adapter LUID, vendor/device/subsystem IDs, cache header, pipeline-library version and current device identity.
- Move the cache between two adapters while rebuilding from source on the second adapter as the control.
The comparison with D3D12_ERROR_DRIVER_VERSION_MISMATCH is especially useful: D3D12_ERROR_DRIVER_VERSION_MISMATCH keeps the adapter but changes the driver/runtime version.
Verify the repaired path
Key cached pipeline data by adapter identity and fall back to rebuilding the PSO when the key changes.
- debug-layer, ETW or driver diagnostics no longer report the rejected cached Direct3D 12 pipeline state identity contract during the same scenario.
Implementation notes
Technical references
- Microsoft: Direct3D 10 return codes — background for the cached Direct3D 12 pipeline state identity.
- Microsoft: Direct3D 11 return codes
- Microsoft: Direct3D 12 return codes
- Microsoft: Use the Direct3D 11 debug layer
Looking for a different code? Search another status or error code.