VKDESTROYPIPELINE(3)

NAME
vkDestroyPipeline - Destroy a pipeline object

C SPECIFICATION

    void vkDestroyPipeline(
        VkDevice                                    device,
        VkPipeline                                  pipeline,
        const VkAllocationCallbacks*                pAllocator);

PARAMETERS

device
    Logical device which owns the object.

pipeline
    The handle of the object to destroy.

DESCRIPTION

vkDestroyPipeline destroys the pipeline object whose handle is specified in pipeline. pipeline must be a valid handle to a pipeline created through a successful call to vkCreateGraphicsPipelines or vkCreateComputePipelines on device. Attempts to destroy VK_NULL_HANDLE are silently ignored. Once a pipeline has been destroyed, its handle becomes invalid and must not be accessed again.

VALID USAGE

    • device must be a valid VkDevice handle

    • If pipeline is not VK_NULL_HANDLE, pipeline must be a valid VkPipeline handle

    • If pAllocator is not NULL, pAllocator must be a pointer to a valid VkAllocationCallbacks structure

    • If pipeline is a valid handle, it must have been created, allocated or retrieved from device

    • Each of device and pipeline that are valid handles must have been created, allocated or retrieved from the same VkPhysicalDevice

    • All submitted commands that refer to pipeline must have completed execution

    • If VkAllocationCallbacks were provided when pipeline was created, a compatible set of callbacks must be provided here

    • If no VkAllocationCallbacks were provided when pipeline was created, pAllocator must be NULL

HOST SYNCHRONIZATION

    • Host access to pipeline must be externally synchronized

SEE ALSO

vkCreateGraphicsPipelines, vkCreateComputePipelines

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.