SetEnabled

Enable or disable the state of AMD SmartAccess Memory on a GPU.

Syntax

Copied!

ADLX_RESULT     SetEnabled (adlx_bool enable)

Parameters

  1. [in] enable adlx_bool The new AMD SmartAccess Memory state. Set true to enable AMD SmartAccess Memory. Set false to disable AMD SmartAccess Memory.

Return Value

If the state of AMD SmartAccess Memory is successfully set, ADLX_OK is returned.

If the state of AMD SmartAccess Memory is not successfully set, an error code is returned.

Refer to ADLX_RESULT for success codes and error codes.

Remarks

The SetEnabled method triggers an asynchronous operation that results in changing the maximum size of VRAM of a GPU that the CPU can address.

While this operation is in progress, the applications that run in the context of the GPU or make calls in the driver for the GPU will behave unexpectedly. Before making this call, ensure that these applications release the GPU context, such as by closing their user interfaces, and that they will not make calls into the GPU driver during this operation. This procedure will allow those applications to continue to function correctly during and after the operation is completed.

To learn when the operation is completed, register an event listener interface using GetGPUTuningChangedHandling before calling SetEnabled. ADLX will call OnGPUTuningChanged into the event listener interface twice during the asynchronous execution of SetEnabled : once before the operation is started, and the second time, after the operation is completed. Use IsSmartAccessMemoryChanged and GetSmartAccessMemoryStatus to discover the state of this operation.

Requirements

Header

include “ISmartAccessMemory.h”

Minimum version

1.2