FFmpeg API 遷移指南：解決 C4996 avcodec_alloc_frame 棄用警告，改用 av_frame_alloc

直接替換對照表

程式碼遷移前後對比

舊寫法（FFmpeg 3.x 風格）

AVFrame* frame = avcodec_alloc_frame();
if (!frame) return -1;

// 設定參數後分配緩衝區
avpicture_alloc((AVPicture*)frame, AV_PIX_FMT_YUV420P, width, height);

// ... 使用 frame ...

avpicture_free((AVPicture*)frame);
avcodec_free_frame(frame);

新寫法（FFmpeg 4.x+ 風格）

AVFrame* frame = av_frame_alloc();
if (!frame) return -1;

frame->format = AV_PIX_FMT_YUV420P;
frame->width  = width;
frame->height = height;

int ret = av_frame_get_buffer(frame, 32);  // 32-byte 對齊
if (ret < 0) {
    av_frame_free(&frame);
    return ret;
}

// ... 使用 frame ...

av_frame_unref(frame);  // 釋放緩衝區引用計數
av_frame_free(&frame);  // 釋放 AVFrame 結構體

關鍵差異與注意事項

• 統一物件模型：AVFrame 同時用於編碼/解碼/濾鏡，不再區分 AVPicture。
• 引用計數：新 API 採用 refcount 機制，av_frame_ref()/unref() 管理緩衝區生命週期，支援零拷貝傳遞。
• 對齊參數：av_frame_get_buffer(frame, align) 的 align 建議 32 或 64（SIMD 優化需求）。
• 編譯旗標：若暫時不想改碼，可在專案屬性 C/C++ → Command Line → Additional Options 加入 /wd4996 抑制警告（不建議長期使用）。

相關常見遷移項目

官方遷移文件參考

• FFmpeg Changelog：doc/Changelog 或 線上版
• API 文件：libavutil/frame.h, libavcodec/avcodec.h 中的 @deprecated 標註。

1. 上一篇文章： Windows 上手 FFmpeg 開發環境建置完整教學：VS2013 專案設定、DLL 部署與除錯驗證
2. 下一篇文章： 減少 C++ 編譯時間的三大核心策略：前向聲明、Pimpl、扁平化繼承

關於C語言

C 語言條件語句詳解：if、if-else、switch 三大控制結構

C 語言條件語句詳解：if、if-else、switch 三

C 語言中雙字節 ASCII 碼表示漢字的原理與實踐：從「我愛朱慧」到「我愛你」

前言：一串神秘數字引發的探索 一切始於一個百度知道的問題：2

UVA 1368 DNA Consensus String（共識字符串）問題詳解與解法

UVA 1368 DNA Consensus String（

WPF/Silverlight 遊戲開發教程 (二十-3)：完美遮罩層與換裝系統實作

完美遮罩層：基於 ZIndex 的畫家算法 第十一節實現的遮