Function Prototype

vkDestroySampler

Destroy a sampler object

To destroy a sampler, call:

void vkDestroySampler(
    VkDevice device,
    VkSampler sampler,
    const VkAllocationCallbacks* pAllocator);
  • device is the logical device that destroys the sampler.
  • sampler is the sampler to destroy.
  • pAllocator controls host memory allocation as described in the Memory Allocation chapter.

Valid Usage

VUID-vkDestroySampler-sampler-01082

All submitted commands that refer to sampler must have completed execution

VUID-vkDestroySampler-sampler-01083

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

VUID-vkDestroySampler-sampler-01084

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

Valid Usage (Implicit)

VUID-vkDestroySampler-sampler-parameter

If sampler is not VK_NULL_HANDLE, sampler must be a valid VkSampler handle

VUID-vkDestroySampler-pAllocator-parameter

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

VUID-vkDestroySampler-sampler-parent

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

Host Synchronization

  • Host access to sampler must be externally synchronized ::