VKMERGEPIPELINECACHE(3)

NAME
vkMergePipelineCaches - Combine the data stores of pipeline caches.

C SPECIFICATION

    VkResult vkMergePipelineCaches(
        VkDevice                                    device,
        VkPipelineCache                             dstCache,
        uint32_t                                    srcCacheCount,
        const VkPipelineCache*                      pSrcCaches);

PARAMETERS

device
    A handle to the device that is the parent of the pipeline caches.

dstCache
    The pipeline cache the combined data will be stored into.

srcCacheCount
    The number of pipeline caches in the pSrcCaches array.

pSrcCaches
    An array of pipeline caches to be combined.

DESCRIPTION

This command combines the caches in the pSrcCaches array, storing the result in dstCache.

VALID USAGE

    • device must be a valid VkDevice handle

    • dstCache must be a valid VkPipelineCache handle

    • pSrcCaches must be a pointer to an array of srcCacheCount valid VkPipelineCache handles

    • srcCacheCount must be greater than 0

    • dstCache must have been created, allocated or retrieved from device

    • Each element of pSrcCaches must have been created, allocated or retrieved from device

    • Each of device, dstCache and the elements of pSrcCaches must have been created, allocated or retrieved from the same VkPhysicalDevice

    • dstCache must not appear in the list of source caches

HOST SYNCHRONIZATION

    • Host access to dstCache must be externally synchronized

RETURN CODES

On success, this command returns

        • VK_SUCCESS

On failure, this command returns

        • VK_ERROR_OUT_OF_HOST_MEMORY

        • VK_ERROR_OUT_OF_DEVICE_MEMORY

SEE ALSO

vkCreatePipelineCache, vkCreateGraphicsPipelines, vkCreateComputePipelines, vkGetPipelineCacheData

COPYRIGHT

Copyright © 2014-2016 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

AUTHOR

Khronos Group
    Author.