| Previous | Next |
| D3D11_ERROR_TOO_MANY_UNIQUE_STATE_OBJECTS | D3D11_ERROR_TOO_MANY_UNIQUE_VIEW_OBJECTS |
D3D11_ERROR_FILE_NOT_FOUND
Interpret the result in its owning layer: file not found
D3D11_ERROR_FILE_NOT_FOUND (0x887C0002) belongs to the d3d layer. It marks a helper API could not open the shader, compiled blob, texture or other requested file, rather than a generic rendering failure. The object that owns the decision is Direct3D 11 file-backed input.
Capture before recreating objects
| Capture item | Why it matters |
|---|---|
| What to capture | normalized path, package contents, current directory, HRESULT from the underlying file operation and deployment version |
| 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 |
| Object identity | Direct3D 11 file-backed input |
| Rejected condition | a helper API could not open the shader, compiled blob, texture or other requested file |
Reproduce one variable at a time
- Capture the failing state. Record normalized path, package contents, current directory, HRESULT from the underlying file operation and deployment version.
- Copy the exact asset to a known path and compare absolute and relative lookup behavior.
The comparison with D3D10_ERROR_FILE_NOT_FOUND is especially useful: D3D10_ERROR_FILE_NOT_FOUND is the equivalent result from Direct3D 10 helpers.
Recovery contract
Repair deployment or path construction while preserving shader compilation errors as separate diagnostics.
- debug-layer, ETW or driver diagnostics no longer report the rejected Direct3D 11 file-backed input contract during the same scenario.
Implementation notes
Technical references
- Microsoft: Direct3D 10 return codes — background for the Direct3D 11 file-backed input.
- 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.