| Previous | Next |
| VFW_E_NO_INTERFACE | VFW_E_CANNOT_CONNECT |
VFW_E_NOT_FOUND
Meaning
Windows documents VFW_E_NOT_FOUND as “An object or name was not found”. In practical terms, it is returned when a DirectShow lookup cannot find the requested filter, pin, object or name in its current scope.
Where the failure belongs
This result belongs to DirectShow filter-graph processing. The relevant condition is that a DirectShow lookup cannot find the requested filter, pin, object or name in its current scope.
Likely causes
- Possible cause 1: the filter or pin was removed during graph reconstruction.
- Possible cause 2: the caller uses a display name that does not match the registered component.
- Possible cause 3: enumeration was performed in another device category or graph instance.
Evidence to collect
- Capture 1: requested name or identifier and lookup scope.
- Capture 2: current graph filter and pin enumeration.
- Capture 3: device-category registration and hardware presence.
Diagnostic sequence
- Confirm that the observed path matches this condition: a DirectShow lookup cannot find the requested filter, pin, object or name in its current scope.
Correct handling and retry
- Corrective action 1: enumerate the current scope and use stable identifiers where available.
- Corrective action 2: invalidate cached names after graph or device changes.
- Corrective action 3: distinguish optional absence from installation failure.
Retry guidance. Retry after enumeration changes or device arrival; repeated lookup of the same absent name should be bounded.
Practical scenario
A capture device is unplugged after its friendly name is cached; re-enumerating devices prevents repeated it.
Difference from nearby HRESULTs
VFW_E_ENUM_OUT_OF_RANGE means enumeration reached its end, while it means a particular requested object or name was not located.
Official Microsoft references
Looking for a different code? Search another status or error code.