IDXGIAdapter3::RegisterVideoMemoryBudgetChangeNotificationEvent method (dxgi1_4.h)

This method establishes a correlation between a CPU synchronization object and the budget change event.

Syntax

HRESULT RegisterVideoMemoryBudgetChangeNotificationEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

Parameters

[in] hEvent

Type: HANDLE

Specifies a HANDLE for the event.

[out] pdwCookie

Type: DWORD*

A key value for the window or event to unregister. The IDXGIAdapter3::RegisterHardwareContentProtectionTeardownStatusEvent method returns this value.

Return value

Type: HRESULT

This method returns an HRESULT success or error code.

Remarks

Instead of calling QueryVideoMemoryInfo regularly, applications can use CPU synchronization objects to efficiently wake threads when budget changes occur.

Requirements

Requirement Value
Target Platform Windows
Header dxgi1_4.h (include DXGI1_3.h)
Library Dxgi.lib
DLL Dxgi.dll

See also

IDXGIAdapter3