ID3D12Device1::SetEventOnMultipleFenceCompletion method (d3d12.h)

Specifies an event that should be fired when one or more of a collection of fences reach specific values.

Syntax

HRESULT SetEventOnMultipleFenceCompletion(
  [in] ID3D12Fence                     * const *ppFences,
  [in] const UINT64                    *pFenceValues,
       UINT                            NumFences,
       D3D12_MULTIPLE_FENCE_WAIT_FLAGS Flags,
       HANDLE                          hEvent
);

Parameters

[in] ppFences

Type: ID3D12Fence*

An array of length NumFences that specifies the ID3D12Fence objects.

[in] pFenceValues

Type: const UINT64*

An array of length NumFences that specifies the fence values required for the event is to be signaled.

NumFences

Type: UINT

Specifies the number of fences to be included.

Flags

Type: D3D12_MULTIPLE_FENCE_WAIT_FLAGS

Specifies one of the D3D12_MULTIPLE_FENCE_WAIT_FLAGS that determines how to proceed.

hEvent

Type: HANDLE

A handle to the event object.

Return value

Type: HRESULT

This method returns an HRESULT success or error code.

Remarks

To specify a single fence refer to the SetEventOnCompletion method.

If hEvent is a null handle, then this API will not return until the specified fence value(s) have been reached.

Requirements

See also

ID3D12Device1