GpaContinueSampleOnCommandList

Copyright (c) 2018-2024 Advanced Micro Devices, Inc. 保留所有权利。

语法

GpaStatus GpaContinueSampleOnCommandList(
    GpaUInt32 src_sample_id,
    GpaCommandListId primary_command_list_id);

描述

将一个采样从一个主命令列表继续到另一个主命令列表。此函数仅支持 DirectX 12 和 Vulkan。通常，采样必须在同一个命令列表中开始和结束。使用此函数，可以在一个主命令列表中开始采样，并在另一个主命令列表中继续/结束采样，从而允许单个采样跨越多个命令列表。

参数

名称	描述
src_sample_id	正在不同命令列表中继续的采样 ID。
primary_command_list_id	先前创建的主命令列表的唯一标识符，采样将在其上继续。

返回值

返回值	描述
kGpaStatusOk	采样已成功在指定的命令列表中继续。
kGpaStatusErrorGpaNotInitialized	GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。
kGpaStatusErrorNullPointer	提供的 primary_command_list_id 参数为 NULL。
kGpaStatusErrorCommandListNotFound	提供的 primary_command_list_id 参数未被识别为先前创建的命令列表标识符。
kGpaStatusErrorSampleNotFound	未找到指定的采样。
kGpaStatusErrorApiNotSupported	当前 API 不支持此函数。仅 DirectX 12 和 Vulkan 支持此 API。
kGpaStatusErrorFailed	采样未能继续到指定的命令列表中。
kGpaStatusErrorException	发生异常。