wfdCreateDestinationFromImagesQNX()
Allocate a destination from a set of image buffers
Synopsis:
#include <wfd/wfdext.h>
__errno_t wfdCreateDestinationFromImagesQNX(WFDDevice device, WFDint count, const WFDEGLImage *images, const _Intptrt *attribList, WFDDestinationQNX *destination_out)
Arguments:
- device
- A WFD device handle.
- count
- The number of image buffers.
- images
- The set of image buffers for the destination to use. The destination retains references to the memory described by these structures, but the driver will not access the structures themselves after this call returns.
- attribList
- Reserved; pass NULL.
- destination_out
- A pointer to a location where on success the function stores the created destination handle.
Library:
libWFDclientDescription:
To enable writeback, bind the returned destination to a port that advertises WFD_PORT_WRITEBACK_SUPPORT_QNX
. Requires the WFD_QNX_port_writeback
extension.
This function does not affect values returned by wfdGetError()
.
Note:
You need to allocate all image buffers with the same parameters: width, height, and format.
Note:
A driver may return ENOTSUP if there isn't enough image buffers. Typically 3 is recommended and 2 is the minimum.
Returns:
- EOK
-
Success;
*destination_out
was filled.
- EACCES
- The images couldn't be opened for write access.
- EBADF
- An image contained an invalid file descriptor.
- EBUSY
- An image is already being used by the driver.
- EINVAL
- An invalid parameter value was specified.
- EMFILE
- No file descriptors are available in this process.
- ENFILE
- No file descriptors are available in the system.
- ENOENT
- A bad handle was specified.
- ENOMEM
- Not enough memory or address space.
- ENOTSUP
- An unsupported attribute was provided, or 'count' was too low.
Page updated: