VK_EXT_external_memory_dma_buf vysvětlen: zero-copy DMA-Buf → VkImage

Předchozí příspěvek pokryl jak jsou pixely rozloženy (DRM modifiéry). Toto je mechanismus, který je dostane do Vulcanu: DMA-Buf je kernel-vlastněné fd referencující GPU paměť alokovanou jiným driverem (VAAPI, V4L2, GBM, kamera). VK_EXT_external_memory_dma_buf vám umožní nárokovat to fd jako VkDeviceMemory a nabindovat ho na VkImage — výsledek decode je textura, žádná kopie.

Pipeline

flow.txt
decoder (VAAPI) ──► DMA-Buf fd ──► vkGetMemoryFdPropertiesKHR
                                   (validate: is it a dma-buf, which
                                    memory types accept it)
                                ──► vkAllocateMemory(ImportMemoryFdInfoKHR)
                                ──► vkBindImageMemory → VkImage
                                ──► sampled in shader

Jedno fd → jedna VkDeviceMemory → jeden VkImage. Kernel drží backing stránky; Vulkan jen mapuje stejnou fyzickou paměť.

Kód

import.cpp
// 1. validate the fd is importable + get allowed memory types:
vk::MemoryFdPropertiesKHR fdProps =
    dev.getMemoryFdPropertiesKHR(
        vk::ExternalMemoryHandleTypeFlagBits::eDmaBufEXT, fd);
// fdProps.memoryTypeBits — which memory types can host it

// 2. allocate with the fd chained in:
vk::ImportMemoryFdInfoKHR imp{};
imp.handleType = vk::ExternalMemoryHandleTypeFlagBits::eDmaBufEXT;
imp.fd         = dup(fd);   // Vulkan takes ownership of its own fd

vk::MemoryAllocateInfo mai{};
mai.pNext          = &imp;
mai.allocationSize = size;      // from the image's mem requirements
mai.memoryTypeIndex = pickType(fdProps.memoryTypeBits,
                               eDeviceLocal);
auto mem = dev.allocateMemory(mai);
dev.bindImageMemory(img, mem, 0);

Na dup(fd) záleží — vkAllocateMemory fd konzumuje; svůj originál si necháváte pro ostatní uživatele DMA-Bufu.

Multi-plane images

planes.txt
NV12 DMA-Buf = one fd, two planes (Y, UV):
  → VkImage per plane OR VkImage with multiple planes
    (eG8B8R82Plane420Unorm + VK_IMAGE_CREATE_DISJOINT +
     vkBindImageMemory2 per plane — the disjoint path)
  → OR: two separate VkImages (R8 + R8G8), one fd per plane —
    VAAPI often splits it this way per-layer

Zpracujte oba layouty: jedna multi-plane vrstva nebo per-plane fd — AVDRMFrameDescriptor vám řekne který.

Vlastnictví a lifetime

  • Fd je lifetime — když decoder buffer znovupoužije, fd může být recyklováno; držte VkImage naživu, dokud decoder nesignalizuje, že je buffer volný.
  • VK_EXT_queue_family_foreign je sync polovina — data DMA-Bufu jsou zapsána foreign queue (decoderovou); queue-family transfer činí zápisy viditelnými.
  • Modifiéry rozhodují tiling — DMA-Buf import nenastavuje layout; eDrmFormatModifierEXT (předchozí příspěvek) ano.

Praktická pravidla

  • Vždy dup() fd — vkAllocateMemory přebírá vlastnictví předaného fd; sdílený originál nechává exporteru buffer.
  • Zkontrolujte memoryTypeBits z getMemoryFdPropertiesKHR — importovaný DMA-Buf může na některých driverech dopadnout jen do DEVICE_LOCAL typů.
  • Vytvoření VkImage musí deklarovat externalMemory usage + eDrmFormatModifierEXT tiling — kombinace signalizuje “foreign paměť, modifier layout”.
  • offset/stride fd v AVDRMFrameDescriptor ≠ interní offsety image — VkImageDrmFormatModifierExplicitCreateInfoEXT je přišpendlí, je-li potřeba; jednoduchý seznam pDrmFormatModifiers nechává vybrat driver.
  • Na failure cestě fallbackněte na av_hwframe_transfer_data + CPU staging — import je rychlá cesta, ne jediná cesta.

Podívejte se na podobné články podle kategorie: Vulkan C++ Linux