| Previous | Next |
| NS_S_WMR_PINTYPEPARTIALMATCH | NS_S_WMG_ADVISE_DROP_FRAME |
NS_S_WMR_PINTYPEFULLMATCH
Windows Media pin type fully matches
NS_S_WMR_PINTYPEFULLMATCH is HRESULT 856161 (0x000D1061) from Windows Media. AllStat describes it as “The specified type fully matches this pin type.” The severity bit indicates a nonfailure result, but the value carries a specific condition that must not be collapsed into plain S_OK.
In the legacy Windows Media pipeline or Player state, this result means that the specified type fully matches this pin type. A generic success branch is insufficient for this HRESULT because continuation and output validity remain code-specific.
Where the status is encountered
- Windows Media source, reader, writer, or renderer callbacks; log the exact method and object state instead of interpreting the constant outside that contract.
- Windows Media Player SDK automation; log the exact method and object state instead of interpreting the constant outside that contract.
- Media graph, playlist, image, rights, or buffering state; log the exact method and object state instead of interpreting the constant outside that contract.
Because it is informational, a language binding may expose it as success and hide the symbolic distinction. Keep the original HRESULT available until the code-specific branch has run.
What must be true before accepting it
Verify that the complete media type is compatible and the intended pins can connect without hidden format conversion. This boundary is where it changes from useful state information into a potentially mishandled result.
A retry decision for this HRESULT requires evidence about already-completed work and outstanding work.
Evidence and telemetry
- preserve complete AM_MEDIA_TYPE fields.
- preserve source and target pin IDs.
- preserve allocator requirements.
- preserve connection HRESULT.
- preserve graph state after connection.
Also record ns_s_wmr_pintypefullmatch_operation, ns_s_wmr_pintypefullmatch_state_before, ns_s_wmr_pintypefullmatch_state_after, UTC time, process and thread identifiers, component version, and a correlation ID. Collect it evidence with least disclosure: retain structure, sizes, IDs, and versions rather than secrets.
Correct handling and recovery
Connect the pins using the confirmed type, then verify allocator and timing requirements. Retain the negotiated type for diagnostics.
Retry it only when a documented input or state has changed. A blind retry of it can duplicate effects or conceal a terminal condition, so require a documented trigger.
Difference from nearby results
It must be distinguished from ordinary S_OK and from failure-severity values in the same API family; its documented state changes control the next action.
Branching precisely on it prevents cancellation, pending work, and partial output from sharing one path.
Practical scenario
A decoder output and renderer input expose identical audio media types. The graph connects them directly and records the allocator properties.
A regression test should reproduce it, assert the relevant outputs and state, then change only the decisive condition and verify the expected neighboring result or ordinary completion.
References
- Microsoft: Windows Media Format SDK error codes — official Microsoft material used to interpret it.
- Microsoft: Windows Media Player SDK
- Microsoft: Windows Media Player buffering event
- Microsoft: HRESULT values
Looking for a different code? Search another status or error code.