IDXGIOutput::TakeOwnership Method

Takes ownership of an output. In Xbox One, this method does nothing, and always returns S_OK.

Syntax

public:
HRESULT TakeOwnership(
         IUnknown *pDevice,
         BOOL Exclusive
)

Parameters

pDevice
Type: IUnknown *

[in] 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

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

Requirements

Header: Declared in d3d11_x.h (dxgi.h on other Windows platforms).

Library: Use d3d11_x.lib (dxgi.lib on other Windows platforms).