FFmpeg hwcontext_vulkan で GPU ビデオデコードとゼロコピー Vulkan 相互運用を行う方法

# 完全に GPU 上でデコード——出力はデバイスに留まる：
ffmpeg -init_hw_device vulkan=vk0 -hwaccel vulkan \
       -hwaccel_output_format vulkan \
       -i input.mp4 -f null -

# デコード → vulkan フィルタ → h264_vulkan に再エンコード：
ffmpeg -init_hw_device vulkan=vk0 -hwaccel vulkan -i in.mp4 \
       -vf "scale_vulkan=w=1280:h=720" \
       -c:v h264_vulkan -y out.mp4

// デバイスを作成（または av_hwdevice_ctx_create_derived で自分のを再利用）：
AVBufferRef* hwDev = nullptr;
av_hwdevice_ctx_create(&hwDev, AV_HWDEVICE_TYPE_VULKAN,
                       /*device*/ nullptr, /*opts*/ nullptr, 0);
// → FFmpeg がデフォルトアダプタを選ぶ。固定するには "vulkan=0" /device アドレスを渡す

// デコードでフレームは AV_PIX_FMT_VULKAN として届く：
AVFrame* f = av_frame_alloc();
avcodec_receive_frame(dec, f);
if (f->format == AV_PIX_FMT_VULKAN) {
    AVVkFrame* vkF = (AVVkFrame*)f->data[0];
    VkImage   img   = vkF->img[0];         // プレーンごとの VkImage
    VkSemaphore sem = vkF->sem[0];         // デコード完了時
    VkSemaphore sem2= vkF->sem[1];         // アプリが待つべき時
    VkImageLayout layout = vkF->layout[0];
    // Y/U/V 用プレーン 0..2 — 同じ VkImage かプレーンごとに分離
}

FFmpeg vk デバイス ─┐
                    ├─ 同じ VkDevice（派生コンテキスト）→ イメージ直接使用
自分の VkDevice   ──┘   ↓ eShaderReadOnlyOptimal へのレイアウト遷移
                    または av_hwframe_map → AV_PIX_FMT_DRM_PRIME → dmabuf
                    → 自分のレンダラーで vkImportMemoryFdKHR（VA-API パス）

AVFrame* drm = av_frame_alloc();
av_hwframe_map(drm, vkFrame, AV_HWFRAME_MAP_READ);
// drm->data[0] = AVDRMFrameDescriptor* → VA-API 投稿と同じパス

// ドライバーはビデオキューを公開しなければならない：
auto qf = dev.getQueueFamilyProperties();
bool hasDec = std::ranges::any_of(qf, [](auto& q){
    return bool(q.queueFlags & vk::QueueFlagBitsKHR::eVideoDecodeKHR);});
// コーデックレベル：vkGetPhysicalDeviceVideoCapabilitiesKHR と
//   VkVideoProfileInfoKHR{videoCodecOperation = eDecodeH264/…}