IDirect3DDevice8::ResourceManagerDiscardBytes

Invokes the resource manager to free memory.

HRESULT ResourceManagerDiscardBytes(
  DWORD Bytes
);

Parameters

Bytes

[in] The number of target bytes to discard. If zero, then the resource manager should discard all bytes.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

The resource manager frees up memory allocations until the number of target bytes is reached. The resource manager follows a least-recently-used (LRU) priority technique.

Note that the number of bytes freed are not guaranteed to be contiguous. Therefore you might not be able to create a resource that takes the number of bytes specified in Bytes after calling this method.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.