From patchwork Fri Dec 29 04:23:57 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Xiang, Haihao" X-Patchwork-Id: 45378 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:6623:b0:194:e134:edd4 with SMTP id n35csp4581383pzh; Thu, 28 Dec 2023 20:24:27 -0800 (PST) X-Google-Smtp-Source: AGHT+IHWgz09LFwFYujzDaBZiURXzeUSn/1kkrJ2YpuLONBNrfDJj/SIqg2qz2EKNVDeeiJE8RuJ X-Received: by 2002:a19:6d1d:0:b0:50e:3ca0:d695 with SMTP id i29-20020a196d1d000000b0050e3ca0d695mr3660698lfc.89.1703823867386; Thu, 28 Dec 2023 20:24:27 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703823867; cv=none; d=google.com; s=arc-20160816; b=U+UBsmZdoolpqkOoqlXJThjbPP2ELLj9E4hHGYxtGWrNpLGhsk7SGCIOJlWbsw3fcz SOss8HftIaS2FdK76JL+OlkbQmplYgq+9JxC/caI6RTFTXQnXvvyKGXx3vAk7bA2weFb ABkT773LxMWusGipdz8ssZpkE/+Ai/yXNvWkE1PVYZPNaEMCpJLPDiyhKU8Sz+iP3brX gRILxiwT57pEuYJhE/fZ02WnXTbLXSlH9ICgYphRSJOqbUPROLkNsuCbMop+54CkmbZL VZiewNwIusQs+puWcZBspy3QLV0djADcgJNY2akcx7NrLLMAx0GbHfrTaK84i5VospBR gC/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:mime-version:message-id:date:to:from :dkim-signature:delivered-to; bh=zcCl1aPgBW78sFgLj+o8sDGUXTbu8lBHPJDPHcd1X0E=; fh=1kpmTRI1sW42eNCnNMby7VLIISQBX6KJuVYxOEG0t2A=; b=fkt/LJo4l8gnX8krxqTdAQCRQFmOuyn86k97Ql75rsL+8Eqd2X73rvfq7ulEQVBagY yHSrknEn9yhN4YvB4VoDAaAFUzaT6X3+ceTDZfyh6vocOm8LBBx894TTn0NOkmou1qGd CiFJNZJbbQPBQ+krnDLihN3735FWY6Kv18i8iIPteQtlO1v2inTJWvLTiLdumhqZnsNs 90KwZ247eZChg1T2/LsSthoX7nOmU7sbxdz2X4l617xWirtjbnfIho3oOC6C6nDbtnYA FhykOg7A0mk5rKU4sliHl+FSz/nuDq1XxGqSeCfbDQm8q56Go58Tu51Y+SWjDZ+mUGIo VREA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@intel.com header.s=Intel header.b=DPFDeuxv; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id z4-20020a056402274400b00553d7f28c10si7639791edd.550.2023.12.28.20.24.26; Thu, 28 Dec 2023 20:24:27 -0800 (PST) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@intel.com header.s=Intel header.b=DPFDeuxv; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id D41DC68CCCB; Fri, 29 Dec 2023 06:24:22 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.93]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 50D5A68CC6C for ; Fri, 29 Dec 2023 06:24:15 +0200 (EET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1703823860; x=1735359860; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=OqktRoXRb1xzIocAthiInPIfGDItQtGD1sB6WNX7yEY=; b=DPFDeuxv8TFHOWFEjoG+CfAelQ+qTBvTWD35OeL4yQQjwNCqFMMTABgf eoho+zsNahNVgkse4VrYDFzwuDUtUuaRIyRWAzS/aXMCxWJp5mFZdjE6E O4GZYtX5P+6H5oe244Zb7xRzraJ17Q8CKKe8vXjHPTze/ZC3rwpQwGkTM JR4PD0uy7bB9t9SyUD3OM9w3okyJLGkq5KZLhmMuwrI9WtOTVEq5rNhVc mYCp2WaScX60RUB8liKcdUO2wFz8O7ZY9vaR3MfLy1v4zEaFATiIi5kgU J+pn7pxvP1F/6aOHfTuqUE6FWlrYetMJgSUcmBI95qq1leaakV+XRwvZ6 A==; X-IronPort-AV: E=McAfee;i="6600,9927,10937"; a="393760012" X-IronPort-AV: E=Sophos;i="6.04,314,1695711600"; d="scan'208";a="393760012" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 28 Dec 2023 20:24:12 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10937"; a="1110073324" X-IronPort-AV: E=Sophos;i="6.04,314,1695711600"; d="scan'208";a="1110073324" Received: from xhh-dg264.sh.intel.com ([10.238.2.76]) by fmsmga005-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 28 Dec 2023 20:24:11 -0800 From: "Xiang, Haihao" To: ffmpeg-devel@ffmpeg.org Date: Fri, 29 Dec 2023 12:23:57 +0800 Message-Id: <20231229042358.3703640-1-haihao.xiang@intel.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 1/2] doc/ffmpeg: update the documentation about qsv device creation X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 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: Haihao Xiang Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: 4IJIKB3s/8Kl From: Haihao Xiang Signed-off-by: Haihao Xiang --- doc/ffmpeg.texi | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi index ab17d1d687..c6c0606e8a 100644 --- a/doc/ffmpeg.texi +++ b/doc/ffmpeg.texi @@ -1406,16 +1406,33 @@ If not specified, @samp{auto_any} is used. platform-appropriate subdevice (@samp{dxva2} or @samp{d3d11va} or @samp{vaapi}) and then deriving a QSV device from that.) -Alternatively, @samp{child_device_type} helps to choose platform-appropriate subdevice type. -On Windows @samp{d3d11va} is used as default subdevice type. +The following options are recognized: +@table @option +@item child_device +Specify a DRM render node on Linux or DirectX adapter on Windows +@item child_device_type +Choose platform-appropriate subdevice type. On Windows @samp{d3d11va} is used +as default subdevice type. +@end table Examples: @table @emph +@item -init_hw_device qsv:hw,child_device=/dev/dri/renderD129 +Create a QSV device with @samp{MFX_IMPL_HARDWARE} on DRM render node /dev/dri/renderD129 + +@item -init_hw_device qsv:hw,child_device=1 +Create a QSV device with @samp{MFX_IMPL_HARDWARE} on DirectX adapter 1. The subdevice +type is @samp{d3d11va} if @code{--enable-libvpl} is specified at configuration time, the +subdevice type is @samp{dxva2} if @code{--enable-libmfx} is specified at configuration time. + @item -init_hw_device qsv:hw,child_device_type=d3d11va Choose the GPU subdevice with type @samp{d3d11va} and create QSV device with @samp{MFX_IMPL_HARDWARE}. @item -init_hw_device qsv:hw,child_device_type=dxva2 Choose the GPU subdevice with type @samp{dxva2} and create QSV device with @samp{MFX_IMPL_HARDWARE}. + +@item -init_hw_device qsv:hw,child_device=1,child_device_type=d3d11va +Create a QSV device with @samp{MFX_IMPL_HARDWARE} on DirectX adapter 1 with subdevice type @samp{d3d11va} @end table @item opencl