> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageInstalledCallback

> XPackageInstalledCallback

# XPackageInstalledCallback

[XPackageRegisterPackageInstalled](/reference/system/xpackage/functions/xpackageregisterpackageinstalled) 函数使用的用户定义回调。

## 语法

```cpp theme={null}
void XPackageInstalledCallback(  
         void* context,  
         const XPackageDetails* details  
)  
```

### 参数

*context*   \_In\_\
类型：void\*

传递给 [XPackageRegisterPackageInstalled](/reference/system/xpackage/functions/xpackageregisterpackageinstalled) 函数的上下文。

*details*   \_In\_\
类型：[XPackageDetails\*](/reference/system/xpackage/structs/xpackagedetails)

包含有关包安装的详细信息。

### 返回值

类型：void

返回一个指向包安装详细信息的指针。

## 备注

`XPackageInstalledCallback` 函数用于确定新包何时完全安装完成。以下代码示例在安装新的可下载内容 (DLC) 包时打印一条消息。

```cpp theme={null}
void CALLBACK NewPackageAdded(void* /* context */, const XPackageDetails* details)
{
    if (details->kind == XPackageKind::Content)
    {
        printf("Package added: %s\n", details->displayName);
    }
}

HRESULT ListenForNewDlc(XTaskQueueHandle queue, XTaskQueueRegistrationToken* token)
{
    HRESULT hr = XPackageRegisterPackageInstalled(queue, nullptr, NewPackageAdded, token);
    return hr;
}

void StopListeningForDlc(XTaskQueueRegistrationToken token)
{
    XPackageUnregisterPackageInstalled(token, false);
}
```

有关 XBOX One 主机游戏所使用打包技术的信息，请参阅[打包概述](/build/core-features/common/packaging/overviews/packaging)。有关创建 XVC 包步骤的信息，请参阅[开始为 XBOX 主机打包游戏](/build/core-features/common/packaging/overviews/packaging-getting-started-for-console)。

## 要求

**头文件：** XPackage.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[如何为 PC 和 XBOX One 创建和使用可下载内容包 (DLC)](/build/core-features/common/packaging/packaging-downloadable-content-dlc)\
[XPackage](/reference/system/xpackage/xpackage_members)


## Related topics

- [XPackageRegisterPackageInstalled](/zh-CN/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XPackageDetails](/zh-CN/reference/system/xpackage/structs/xpackagedetails.md)
- [XPackage](/zh-CN/reference/system/xpackage/xpackage_members.md)
- [XPackageEnumerationCallback](/zh-CN/reference/system/xpackage/functions/xpackageenumerationcallback.md)
- [XPackageUnregisterPackageInstalled](/zh-CN/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md)