XPackageCloseMountHandle

지정된 탑재 핸들을 닫고 장치를 분리합니다.

구문

void XPackageCloseMountHandle(  
         XPackageMountHandle mount  
)  

매개 변수

mount _In_
형식: XPackageMountHandle

닫을 탑재 핸들입니다.

반환 값

형식: void

설명

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

XPackageMount가 특정 패키지 식별자를 탑재하고 탑재 핸들을 반환한 후 XPackageCloseMountHandle이 장치를 분리합니다. 이 작업은 몇 초 정도 걸릴 수 있습니다. 패키지 식별자에 대한 자세한 내용은 DLC(다운로드 가능한 콘텐츠 관리 및 라이선스)를참조하세요.

XPackageGetMountPathSize 및 XPackageGetMountPath는 패키지의 콘텐츠에 대한 파일 경로를 반환하는 데 사용됩니다.

콘텐츠 패키지만 탑재할 수 있습니다. 다른 게임을 탑재하려고 시도하면 E_ACCESS_DENIED가 발생합니다.

예제:

HRESULT MountDlc(char* dlcIdentifier)
{
    XPackageMountHandle mountHandle;
    HRESULT hr = XPackageMount(dlcIdentifier, &mountHandle);
    if (FAILED(hr)) return hr;

    size_t pathSize;
    hr = XPackageGetMountPathSize(mountHandle, &pathSize);
    if (FAILED(hr))
    {
        XPackageCloseMountHandle(mountHandle);
        return hr;
    }

    char* path = new (std::nothrow) char[pathSize];
    if (path == nullptr)
    {
        XPackageCloseMountHandle(mountHandle);
        return E_OUTOFMEMORY;
    }

    hr = XPackageGetMountPath(mountHandle, pathSize, path);
    if (FAILED(hr))
    {
        XPackageCloseMountHandle(mountHandle);
        delete[] path;
        return hr;
    }

    printf("Dlc %s mounted at path %s\n", dlcIdentifier, path);

    delete[] path;

    // Unmounts DLC path if this is the last handle
    // to it.
    XPackageCloseMountHandle(mountHandle);
    return S_OK;
}

요구 사항

헤더: XPackage.h

라이브러리: xgameruntime.lib

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

참고 항목

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