GpaCreateSession

语法

GpaStatus GpaCreateSession(
    GpaContextId context_id,
    GpaSessionSampleType sample_type,
    GpaSessionId* session_id);

在指定的上下文中创建一个会话。将返回一个唯一的会话标识符，允许启用计数器、测量样本并存储配置文件的结果。会话的样本类型应由调用者指定。请求的样本类型必须由提供的上下文支持。使用 GpaGetSupportedSampleTypes 来确定上下文支持哪些样本类型。

名称	描述
context_id	先前打开的上下文的唯一标识符。
sample_type	为此会话创建的样本类型。
session_id	成功执行此函数后，此参数将被设置为 GPA 生成的唯一会话标识符。该值随后可以传递给接受 GpaSessionId 作为输入参数的任何 GPA 函数。

返回值	描述
kGpaStatusOk	会话已成功创建。
kGpaStatusErrorGpaNotInitialized	GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。
kGpaStatusErrorNullPointer	提供的 context_id 参数为 NULL。