From 2b16f801f7cb7abdc7dc344455781d6b76aac7a1 Mon Sep 17 00:00:00 2001 From: Carl Zhang Date: Mon, 16 Nov 2026 14:58:08 +0800 Subject: [PATCH] va: Recommend packed header submission in bitstream order Recommend submitting packed header parameter/data pairs in final bitstream order, consistent with codec syntax and semantics, including across vaRenderPicture() calls for the same picture. This allows compatibility with backends that insert headers in submission order without relying on driver-specific reordering. Related: https://github.com/intel/libva/issues/901 Signed-off-by: Carl Zhang --- va/va.h | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/va/va.h b/va/va.h index c47d2b869..bea11231e 100644 --- a/va/va.h +++ b/va/va.h @@ -2443,7 +2443,19 @@ typedef enum { VAEncPackedHeaderMiscMask va_deprecated_enum = 0x80000000, } VAEncPackedHeaderType; -/** \brief Packed header parameter. */ +/** + * \brief Packed header parameter. + * + * Applications should submit packed header parameter/data pairs to + * vaRenderPicture() in the order in which the headers should appear in the + * final bitstream, consistent with the syntax and semantics of the codec + * specification. This ordering should also be preserved across + * vaRenderPicture() calls for the same picture. + * + * This allows compatibility with backend drivers that insert packed headers + * in submission order. Applications should not rely on a backend driver to + * reorder packed headers. + */ typedef struct _VAEncPackedHeaderParameterBuffer { /** Type of the packed header buffer. See #VAEncPackedHeaderType. */ uint32_t type;