From patchwork Sun Jun 21 08:53:47 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andreas Rheinhardt X-Patchwork-Id: 20534 Return-Path: X-Original-To: patchwork@ffaux-bg.ffmpeg.org Delivered-To: patchwork@ffaux-bg.ffmpeg.org Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by ffaux.localdomain (Postfix) with ESMTP id 2A40444B677 for ; Sun, 21 Jun 2020 11:54:23 +0300 (EEST) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 1808468B845; Sun, 21 Jun 2020 11:54:23 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-wr1-f67.google.com (mail-wr1-f67.google.com [209.85.221.67]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id B710E68B617 for ; Sun, 21 Jun 2020 11:54:15 +0300 (EEST) Received: by mail-wr1-f67.google.com with SMTP id l10so13691886wrr.10 for ; Sun, 21 Jun 2020 01:54:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=F4dz0svvRV+F9kZmCMrvT61XY7XesiFolXAbF3VRABg=; b=mwLL6CW7YuPjQJpoVhs5ow74biIKg2r1pkGMVfsfrbSeMCHUQvT73YFgv4MchNJk2m DdM7VSFIXtrufchEBTHgWKE+Yt4jvVmFMuYpLKP44bs+/Bp2HKUzqtHlFDAilvORPcDz 6h1iNBzrv4dTRV5UcIQXgQ06TU/9d5z6iKplOloIN48Pn1BdDQTRS7H7j7uS1mdTgXc4 JBs8tfgmSMnrd9AiKNJY+twp6GON/Hy+uUe9d+m936o0RzDg/k9dNkdmyeh8RaohOStT IRt6mZVG44Oy/VDiHKIXEx3Ti2BGtyBg5ZS5FgSWv4Yv0t0oGHC7xymOotYtUek0iKha MGmQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=F4dz0svvRV+F9kZmCMrvT61XY7XesiFolXAbF3VRABg=; b=oJGmz2LFKR92tMA6C4nqfLX0PXy9rz0qJBc+zpy1ize+dI5IAahXILYOVau152GMmW UPrDfFnNtTCfQVzntw14mlMmckrDH25PxTDjXg0Isem5j4u537BaAQ3HyJsxLAquS2bG zUuqdW3J7SAX6UnsYLB0ZtfxERm1GT/Y6+GOz2k7P9Q0VGNxzzmRasK+T8BJXgRb7mjm 4/gcen/BYsC4oUmHRfAPcTvZsMSVcp4CBFTHjhdVQAxmquN4IEfzsRK3ln88j5hzgGuu LbjpLEPTVhG77fDlPTg+tRbgu7u8JXYO3i9qACpBWXmBlWzM5Lx/0zFGOM7PoZDvXGjf 81wg== X-Gm-Message-State: AOAM533R9gLHboCnfGWKKLQ292vJcMdWUh8IQ+acQ3giNh3j9KuBv+2g eNuGk7/LsVKm1v6HPmfocczR8n5w X-Google-Smtp-Source: ABdhPJyadGBxgyzirJ+x00m1wIEyjJRvhUxpn54aLd/nl4TVPatOBqMpGLm3Qu6D/ZrbJfES2fxo6w== X-Received: by 2002:a5d:6601:: with SMTP id n1mr12441778wru.23.1592729654960; Sun, 21 Jun 2020 01:54:14 -0700 (PDT) Received: from sblaptop.fritz.box (ipbcc1ab57.dynamic.kabel-deutschland.de. [188.193.171.87]) by smtp.gmail.com with ESMTPSA id b143sm12616054wme.20.2020.06.21.01.54.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 21 Jun 2020 01:54:14 -0700 (PDT) From: Andreas Rheinhardt To: ffmpeg-devel@ffmpeg.org Date: Sun, 21 Jun 2020 10:53:47 +0200 Message-Id: <20200621085349.22370-3-andreas.rheinhardt@gmail.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200621085349.22370-1-andreas.rheinhardt@gmail.com> References: <20200621085349.22370-1-andreas.rheinhardt@gmail.com> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 3/5] avcodec/packet: Improve documentation of av_packet_get_side_data X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Andreas Rheinhardt Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Document that it also sets the size in case the desired side data is absent (if the pointer has been supplied). Signed-off-by: Andreas Rheinhardt --- Do this and the next patch actually need a version bump and API change entry? libavcodec/packet.h | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/libavcodec/packet.h b/libavcodec/packet.h index 41485f4527..96f237f091 100644 --- a/libavcodec/packet.h +++ b/libavcodec/packet.h @@ -580,7 +580,8 @@ int av_packet_shrink_side_data(AVPacket *pkt, enum AVPacketSideDataType type, * * @param pkt packet * @param type desired side information type - * @param size pointer for side information size to store (optional) + * @param size If supplied, *size will be set to the size of the side data + * or to zero if the desired side data is not present. * @return pointer to data if present or NULL otherwise */ uint8_t* av_packet_get_side_data(const AVPacket *pkt, enum AVPacketSideDataType type,