diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index af6294968b..df1e247866 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -4286,8 +4286,8 @@ int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width,
  * pix_fmts.
  *
  * @param[in]  pix_fmt the pixel format
- * @param[out] h_shift store log2_chroma_h
- * @param[out] v_shift store log2_chroma_w
+ * @param[out] h_shift store log2_chroma_w
+ * @param[out] v_shift store log2_chroma_h
  *
  * @see av_pix_fmt_get_chroma_sub_sample
  */
diff --git a/libavutil/pixdesc.h b/libavutil/pixdesc.h
index ca0722e1f4..1042e1ed45 100644
--- a/libavutil/pixdesc.h
+++ b/libavutil/pixdesc.h
@@ -225,8 +225,8 @@ enum AVPixelFormat av_pix_fmt_desc_get_id(const AVPixFmtDescriptor *desc);
  * you do check the return code!
  *
  * @param[in]  pix_fmt the pixel format
- * @param[out] h_shift store log2_chroma_h
- * @param[out] v_shift store log2_chroma_w
+ * @param[out] h_shift store log2_chroma_w
+ * @param[out] v_shift store log2_chroma_h
  *
  * @return 0 on success, AVERROR(ENOSYS) on invalid or unknown pixel format
  */