Edit

IDXGIAdapter4::GetDesc3 method (dxgi1_6.h)

  • Article

Gets a Microsoft DirectX Graphics Infrastructure (DXGI) 1.6 description of an adapter or video card. This description includes information about ACG compatibility.

Syntax

HRESULT GetDesc3(
  [out] DXGI_ADAPTER_DESC3 *pDesc
);

Parameters

[out] pDesc

A pointer to a DXGI_ADAPTER_DESC3 structure that describes the adapter.
This parameter must not be NULL. On feature level 9 graphics hardware, early versions of GetDesc3 (GetDesc1, and GetDesc) 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. GetDesc3 and GetDesc2 return the actual feature level 9 hardware values in these members.

Return value

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

Remarks

Use the GetDesc3 method to get a DXGI 1.6 description of an adapter. To get a DXGI 1.2 description, use the IDXGIAdapter2::GetDesc2 method. 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 graphics processing unit (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 GetDesc3 or GetDesc2 methods to retrieve the granularity levels for graphics and compute tasks.

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header dxgi1_6.h
Library DXGI.lib
DLL Dxgi.dll

See also

IDXGIAdapter4