Media (Intel® Video Processing Library, Intel Media SDK)
Access community support with transcoding, decoding, and encoding in applications using media tools like Intel® oneAPI Video Processing Library and Intel® Media SDK
Announcements
The Intel Media SDK project is no longer active. For continued support and access to new features, Intel Media SDK users are encouraged to read the transition guide on upgrading from Intel® Media SDK to Intel® Video Processing Library (VPL), and to move to VPL as soon as possible.
For more information, see the VPL website.

GetHDL documentation bug

BMart1
New Contributor II
266 Views

The documentation for mfxFrameAllocator::GetHDL states:

This function returns the OS-specific handle associated with a video frame. If the handle is a COM interface, the reference counter must increase. The SDK will release the interface afterward.

but all d3d samples simply return the handle without incrementing the ref count. I think the docs are wrong.

Bruno

0 Kudos
1 Reply
Jeffrey_M_Intel1
Employee
266 Views

This function is intended to abstract access to the video frame handle.  The allocator code in the tutorials is simplified to provide a starting point and documentation by example. It is a good starting point reference on this topic.  The simple_gethdl implementations also simply return handles, though there may be more sophisticated scenarios such as when multiple threads might be accessing the same handle where more complexity is necessary.  You are correct though -- the interface does not require incrementing any reference counters.

Thanks for pointing out that more clarification is needed here. Please watch for updates in the documentation as well as Intel Developer Zone articles on this subject.

Regards, Jeff

 

0 Kudos
Reply