IddCxSwapChainReleaseAndAcquireSystemBuffer function (iddcx.h)

Article
02/22/2024

IddCxSwapChainReleaseAndAcquireSystemBuffer releases and acquires buffers from the swapchain.

Syntax

HRESULT IddCxSwapChainReleaseAndAcquireSystemBuffer(
  [in]  IDDCX_SWAPCHAIN                         SwapChainObject,
  [out] IDARG_OUT_RELEASEANDACQUIRESYSTEMBUFFER *pOutArgs
);

Parameters

[in] SwapChainObject

The IDDCX_SWAPCHAIN object used for querying the physical address of the currently acquired surface.

[out] pOutArgs

Pointer to a IDARG_OUT_RELEASEANDACQUIRESYSTEMBUFFER structure in which the resulting information from the release and acquire operation is returned.

Return value

IddCxSwapChainReleaseAndAcquireSystemBuffer returns S_OK on success; otherwise it returns an appropriate error code.

Remarks

In addition to releasing and acquiring buffers from the swapchain, IddCxSwapChainReleaseAndAcquireSystemBuffer also unmaps and unlocks the buffer being released while mapping and locking the buffer being acquired. For this reason, it is not valid to call IddCxSwapChainReleaseAndAcquireBuffer subsequent to calling this method. The IDDCX_SYSTEM_BUFFER_INFO structure pointed to by pBufferInfo is filled with valid information only on a successful release and acquire as indicated by a return value of S_OK.

Requirements

Requirement	Value
Minimum supported server	Windows Server 2022
Header	iddcx.h