> ## 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](/zh-TW/reference/system/xpackage/functions/xpackageregisterpackageinstalled) 函式所使用的使用者定義回呼。

## 語法

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

### 參數

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

傳遞給 [XPackageRegisterPackageInstalled](/zh-TW/reference/system/xpackage/functions/xpackageregisterpackageinstalled) 函式的內容。

*details*   \_In\_\
類型：[XPackageDetails\*](/zh-TW/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 遊戲所使用之封裝技術的相關資訊，請參閱[封裝概觀](/zh-TW/build/core-features/common/packaging/overviews/packaging)。如需建立 XVC 套件之步驟的相關資訊，請參閱[開始為 XBOX 主機封裝遊戲](/zh-TW/build/core-features/common/packaging/overviews/packaging-getting-started-for-console)。

## 需求

**標頭：** XPackage.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[如何為 PC 和 XBOX One 建立及使用可下載內容套件 (DLC)](/zh-TW/build/core-features/common/packaging/packaging-downloadable-content-dlc)\
[XPackage](/zh-TW/reference/system/xpackage/xpackage_members)


## Related topics

- [XPackageInstalledCallback](/es/reference/system/xpackage/functions/xpackageinstalledcallback.md)
- [XPackageRegisterPackageInstalled](/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XPackageDetails](/reference/system/xpackage/structs/xpackagedetails.md)
- [XPackage](/reference/system/xpackage/xpackage_members.md)
- [XPackageUnregisterPackageInstalled](/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md)