.. _cn_api_paddle_device_xpu_max_memory_reserved:

max_memory_reserved
-------------------------------

.. py:function:: paddle.device.xpu.max_memory_reserved(device=None)

返回给定设备上由 Allocator 管理的显存峰值统计。

参数
::::::::

    - **device** (paddle.XPUPlace|int|str，可选) - 设备、设备 ID 或形如 ``xpu:x`` 的设备名称。如果 ``device`` 为 None，则 ``device`` 为当前的设备。默认值为 None。


返回
::::::::

一个整数，表示给定设备上当前由 Allocator 管理的显存峰值统计，以字节为单位。

代码示例
::::::::

COPY-FROM: paddle.device.xpu.max_memory_reserved
