XStoreQueryGameAndDlcPackageUpdatesAsync
게임 패키지 및 해당 패키지에 연결된 모든 DLC 또는 허브 인식 패키지에 사용 가능한 업데이트의 목록을 검색합니다. 해당 목록은 업데이트를 다운로드하고 설치하는 데 사용할 수 있습니다.
구문
HRESULT XStoreQueryGameAndDlcPackageUpdatesAsync(
const XStoreContextHandle storeContextHandle,
XAsyncBlock* async
)
매개 변수
storeContextHandle _In_
형식: XStoreContextHandle
XStoreCreateContext가 반환하는 사용자의 Microsoft Store 컨텍스트 핸들입니다.
async _Inout_
형식: XAsyncBlock*
수행할 비동기 작업을 정의하는 XAsyncBlock입니다. 호출의 상태를 폴링하고 호출 결과를 검색하기 위해 사용할 수 있는 XAsyncBlock입니다. 자세한 내용은 XAsyncBlock을 참조하세요.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
비고
사용 가능한 업데이트 목록과 이 함수의 실행 결과를 함께 검색하려면, 이 함수 호출 후 XStoreQueryGameAndDlcPackageUpdatesResult를 호출합니다. 검색할 업데이트 수를 확인하려면 이 함수 호출 후 XStoreQueryGameAndDlcPackageUpdatesResultCount를 호출합니다. 결과 카운트 함수는 결과 함수를 전달하는 배열의 적절한 크기를 결정할 수 있기 때문에 중요합니다.
| 호출 컨텍스트 | 결과 |
|---|---|
| 프랜차이즈 게임 허브 | 프랜차이즈 게임 허브 자체, 이에 종속된 허브 인식 게임 및 모든 DLC, 허브 인식 게임 또는 프랜차이즈 게임 허브 자체와 관련된 추가 콘텐츠. |
| 기타 게임 | 게임 자체 및 DCC, 이에 연결된 추가 콘텐츠. |
다음 코드 조각은 현재 패키지에 대한 게임 및 선택적인 업데이트를 검색하는 예를 보여줍니다.
struct UpdateContext
{
XStoreContextHandle storeContextHandle;
XTaskQueueHandle taskQueueHandle;
bool downloadOnly;
};
void CALLBACK DownloadAndInstallPackageUpdatesCallback(XAsyncBlock* asyncBlock)
{
HRESULT hr = XStoreDownloadAndInstallPackageUpdatesResult(asyncBlock);
if (FAILED(hr))
{
printf("Failed download and install package updates: 0x%x\r\n", hr);
return;
}
}
void CALLBACK DownloadPackageUpdatesCallback(XAsyncBlock* asyncBlock)
{
HRESULT hr = XStoreDownloadPackageUpdatesResult(asyncBlock);
if (FAILED(hr))
{
printf("Failed download package updates: 0x%x\r\n", hr);
return;
}
}
void CALLBACK QueryGameAndDlcPackageUpdatesCallback(XAsyncBlock* asyncBlock)
{
UpdateContext* updateContext = reinterpret_cast<UpdateContext*>(asyncBlock->context);
uint32_t count;
HRESULT hr = XStoreQueryGameAndDlcPackageUpdatesResultCount(
asyncBlock,
&count);
if (FAILED(hr))
{
printf("Failed retrieve the game and dlc update count: 0x%x\r\n", hr);
delete updateContext;
return;
}
printf("Number of updates: %d", count);
if (count > 0)
{
XStorePackageUpdate* updates = new XStorePackageUpdate[count];
hr = XStoreQueryGameAndDlcPackageUpdatesResult(
asyncBlock,
count,
&updates);
if (FAILED(hr))
{
delete[] updates;
delete updateContext;
printf("Failed retrieve the game and dlc updates: 0x%x\r\n", hr);
return;
}
auto packageIdentifiers = new char[count][XPACKAGE_IDENTIFIER_MAX_LENGTH];
for (uint32_t index = 0; index < count; index++)
{
printf("packageIdentifier: %s\r\n", updates[index].packageIdentifier);
printf("isMandatory : %s\r\n", updates[index].isMandatory ? "true" : "false");
memcpy(&packageIdentifiers[index], updates[index].packageIdentifier, XPACKAGE_IDENTIFIER_MAX_LENGTH);
}
delete[] updates;
auto downloadAsyncBlock = std::make_unique<XAsyncBlock>();
ZeroMemory(downloadAsyncBlock.get(), sizeof(*downloadAsyncBlock));
downloadAsyncBlock->queue = updateContext->taskQueueHandle;
downloadAsyncBlock->context = updateContext;
if (updateContext->downloadOnly)
{
// NOTE: This can be used instead to only perform the download.
// This is helpful if you wish to download in the background
// while the player continues to play. Once the download is completed,
// you could then warn the user and call XStoreDownloadAndInstallPackageUpdatesAsync
// to trigger the game to update which may close the game.
downloadAsyncBlock->callback = DownloadPackageUpdatesCallback;
hr = XStoreDownloadPackageUpdatesAsync(
updateContext->storeContextHandle,
(const char**)(&packageIdentifiers[0]),
count,
downloadAsyncBlock.get());
if (FAILED(hr))
{
delete updateContext;
delete[] packageIdentifiers;
printf("Failed start download: 0x%x\r\n", hr);
return;
}
}
else
{
downloadAsyncBlock->callback = DownloadAndInstallPackageUpdatesCallback;
hr = XStoreDownloadAndInstallPackageUpdatesAsync(
updateContext->storeContextHandle,
(const char**)(&packageIdentifiers[0]),
count,
downloadAsyncBlock.get());
if (FAILED(hr))
{
delete updateContext;
delete[] packageIdentifiers;
printf("Failed start download and install: 0x%x\r\n", hr);
return;
}
}
delete[] packageIdentifiers;
}
else
{
delete updateContext;
}
}
void QueryGameAndDlcPackageUpdates(XStoreContextHandle storeContextHandle, XTaskQueueHandle taskQueueHandle, bool downloadOnly)
{
UpdateContext* updateContext = new UpdateContext;
updateContext->storeContextHandle = storeContextHandle;
updateContext->taskQueueHandle = taskQueueHandle;
updateContext->downloadOnly = downloadOnly;
auto asyncBlock = std::make_unique<XAsyncBlock>();
ZeroMemory(asyncBlock.get(), sizeof(*asyncBlock));
asyncBlock->queue = taskQueueHandle;
asyncBlock->context = updateContext;
asyncBlock->callback = QueryGameAndDlcPackageUpdatesCallback;
HRESULT hr = XStoreQueryGameAndDlcPackageUpdatesAsync(
storeContextHandle,
asyncBlock.get());
if (FAILED(hr))
{
printf("Failed to query game and DLC updates: 0x%x\r\n", hr);
delete updateContext;
return;
}
if(FAILED(XAsyncGetStatus(asyncBlock, true)))
{
printf("XStoreQueryGameAndDlcPackageUpdatesAsync failed\r\n");
return;
}
}
요구 사항
헤더: XStore.h(XGameRuntime.h에 포함됨)
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔
참고 항목
XStore
XStoreQueryGameAndDlcPackageUpdatesResult
XStoreQueryGameAndDlcPackageUpdatesResultCount
프랜차이즈 게임 허브