다음을 통해 공유


XPackageInstalledCallback

XPackageRegisterPackageInstalled 함수에서 사용하는 사용자 정의 콜백입니다.

구문

void XPackageInstalledCallback(  
         void* context,  
         const XPackageDetails* details  
)  

매개 변수

context _In_
형식: void*

XPackageRegisterPackageInstalled 함수에 전달된 컨텍스트입니다.

details _In_
형식: XPackageDetails*

패키지 설치에 관한 세부 정보를 포함합니다.

반환 값

형식: void

패키지 설치 세부 정보에 관한 포인터를 반환합니다.

설명

XPackageInstalledCallback 함수는 새 패키지가 완전히 설치된 시기를 확인하는 데 사용됩니다. 다음 코드 예제에서는 새 DLC(다운로드 가능한 콘텐츠) 패키지가 설치될 때 메시지를 출력합니다.

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 타이틀에 사용되는 패키징 기술에 관한 자세한 내용은 패키징 개요를 참조하세요. XVC 패키지를 만드는 단계에 관한 자세한 내용은 Xbox 콘솔용 타이틀 패키징 시작하기를 참조하세요.

요구 사항

헤더: XPackage.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

PC 및 Xbox One용 DLC(다운로드 가능한 콘텐츠) 패키지를 만들고 사용하는 방법
XPackage