TakeOwnership

IDXGIOutput::TakeOwnership method

Takes ownership of an output.

Syntax


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

Parameters

pDevice [in]

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

Header

DXGI.h

Library

DXGI.lib

See also

IDXGIOutput

 

 

Show:
© 2016 Microsoft