IDXGIOutput::TakeOwnership method (dxgi.h)

Article
2024-02-22

Takes ownership of an output.

Syntax

HRESULT TakeOwnership(
  [in] IUnknown *pDevice,
       BOOL     Exclusive
);

Parameters

[in] pDevice

Type: IUnknown*

A pointer to the IUnknown interface of a device (such as an ID3D10Device).

Exclusive

Type: BOOL

Set to TRUE to enable other threads or applications to take ownership of the device; otherwise, set to FALSE.

Return value

Type: HRESULT

Returns one of the DXGI_ERROR values.

Remarks

When you are finished with the output, call IDXGIOutput::ReleaseOwnership.

TakeOwnership should not be called directly by applications, since results will be unpredictable. It is called implicitly by the DXGI swap chain object during full-screen transitions, and should not be used as a substitute for swap-chain methods.

Notes for Windows Store apps

If a Windows Store app uses TakeOwnership, it fails with DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Requirements

Requirement	Value
Target Platform	Windows
Header	dxgi.h
Library	DXGI.lib

Share via