Skip to content

Latest commit

 

History

History
77 lines (62 loc) · 4.51 KB

nf-dxgi1_2-idxgiadapter2-getdesc2.md

File metadata and controls

77 lines (62 loc) · 4.51 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:dxgi1_2.IDXGIAdapter2.GetDesc2
IDXGIAdapter2::GetDesc2 (dxgi1_2.h)
Gets a Microsoft DirectX Graphics Infrastructure (DXGI) 1.2 description of an adapter or video card.
GetDesc2
GetDesc2 method [DXGI]
GetDesc2 method [DXGI]
IDXGIAdapter2 interface
IDXGIAdapter2 interface [DXGI]
GetDesc2 method
IDXGIAdapter2.GetDesc2
IDXGIAdapter2::GetDesc2
direct3ddxgi.idxgiadapter2_getdesc2
dxgi1_2/IDXGIAdapter2::GetDesc2
direct3ddxgi\idxgiadapter2_getdesc2.htm
direct3ddxgi
DC1A054D-4092-4865-A6EF-B936891AA470
12/05/2018
GetDesc2, GetDesc2 method [DXGI], GetDesc2 method [DXGI],IDXGIAdapter2 interface, IDXGIAdapter2 interface [DXGI],GetDesc2 method, IDXGIAdapter2.GetDesc2, IDXGIAdapter2::GetDesc2, direct3ddxgi.idxgiadapter2_getdesc2, dxgi1_2/IDXGIAdapter2::GetDesc2
dxgi1_2.h
Windows
Windows 8 and Platform Update for Windows 7 [desktop apps \| UWP apps]
Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps \| UWP apps]
Dxgi.lib
Windows
19H1
IDXGIAdapter2::GetDesc2
dxgi1_2/IDXGIAdapter2::GetDesc2
c++
APIRef
kbSyntax
COM
Dxgi.lib
Dxgi.dll
IDXGIAdapter2.GetDesc2

IDXGIAdapter2::GetDesc2

-description

Gets a Microsoft DirectX Graphics Infrastructure (DXGI) 1.2 description of an adapter or video card. This description includes information about the granularity at which the graphics processing unit (GPU) can be preempted from performing its current task.

-parameters

-param pDesc [out]

A pointer to a DXGI_ADAPTER_DESC2 structure that describes the adapter.
This parameter must not be NULL. On feature level 9 graphics hardware, earlier versions of GetDesc2 (GetDesc and GetDesc1) return zeros for VendorId, DeviceId, SubSysId, and Revision members of the adapter description structure and “Software Adapter” for the description string in the Description member. GetDesc2 returns the actual feature level 9 hardware values in these members.

-returns

Returns S_OK if successful; otherwise, returns E_INVALIDARG if the pDesc parameter is NULL.

-remarks

Use the GetDesc2 method to get a DXGI 1.2 description of an adapter. To get a DXGI 1.1 description, use the IDXGIAdapter1::GetDesc1 method. To get a DXGI 1.0 description, use the IDXGIAdapter::GetDesc method.

The Windows Display Driver Model (WDDM) scheduler can preempt the GPU's execution of application tasks. The granularity at which the GPU can be preempted from performing its current task in the WDDM 1.1 or earlier driver model is a direct memory access (DMA) buffer for graphics tasks or a compute packet for compute tasks. The GPU can switch between tasks only after it completes the currently executing unit of work, a DMA buffer or a compute packet.

A DMA buffer is the largest independent unit of graphics work that the WDDM scheduler can submit to the GPU. This buffer contains a set of GPU instructions that the WDDM driver and GPU use. A compute packet is the largest independent unit of compute work that the WDDM scheduler can submit to the GPU. A compute packet contains dispatches (for example, calls to the ID3D11DeviceContext::Dispatch method), which contain thread groups. The WDDM 1.2 or later driver model allows the GPU to be preempted at finer granularity levels than a DMA buffer or compute packet. You can use the GetDesc2 method to retrieve the granularity levels for graphics and compute tasks.

-see-also

IDXGIAdapter2