PFND3D12DDI_BARRIER_0088 callback function (d3d12umddi.h)

Article
09/29/2022

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

A driver's PFND3D12DDI_BARRIER_0088 callback function synchronizes multiple accesses to resources. This callback supports enhanced barriers.

Syntax

PFND3D12DDI_BARRIER_0088 Pfnd3d12ddiBarrier0088;

void Pfnd3d12ddiBarrier0088(
  D3D12DDI_HCOMMANDLIST hDrvCommandList,
  UINT32 NumBarriers,
  const D3D12DDIARG_BARRIER_0088 *pBarriers
)
{...}

Parameters

hDrvCommandList

A handle to the driver's data for the command list. The driver uses this region of memory to store internal data structures that are related to its command list.

NumBarriers

The number of D3D12DDIARG_BARRIER_0088 structures that pBarriers points to.

pBarriers

Pointer to an array of D3D12DDIARG_BARRIER_0088 structures that contain the enhanced barriers. The array size is specified by NumBarriers.

Return value

None

Remarks

Drivers that report support for enhanced barriers must implement the PFND3D12DDI_BARRIER function. How drivers implement the function is up to the hardware vendor, as long as they meet the design specifications and pass all related conformance tests.

A driver supporting enhanced barriers must expect that legacy ResourceBarrier calls will also use the PFND3D12DDI_BARRIER function. The legacy PFND3D12DDI_RESOURCEBARRIER_* table entry can be left as NULL.

Access PFND3D12DDI_BARRIER_0088 by using a command list functions structure such as the D3D12DDI_COMMAND_LIST_FUNCS_3D_0088 structure.

See Enhanced Barriers for general information.

Requirements

Requirement	Value
Minimum supported client	Windows 11 (WDDM 3.0)
Header	d3d12umddi.h