XPackageCloseMountHandle

指定したマウント ハンドルを閉じ、デバイスをマウント解除します。

構文

void XPackageCloseMountHandle(  
         XPackageMountHandle mount  
)  

パラメーター

mount _In_
型: XPackageMountHandle

閉じるマウント ハンドル。

戻り値

型: void

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。

XPackageMount が特定のパッケージ ID をマウントし、これにマウント ハンドルを返した後、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