Skip to main content

XAsyncGetResult

從非同步提供者傳回非同步呼叫的結果。

語法

參數

asyncBlock   _Inout_
類型:XAsyncBlock*
指向為非同步呼叫傳遞給 XAsyncBegin 之 XAsyncBlock 的指標。 identity   _In_opt_
類型:void*
選擇性。指向可用來識別非同步呼叫之任意權杖的指標。如果對應的 XAsyncBegin 呼叫的 identity 參數有指定值,就必須在此指定相同的指標。 bufferSize   _In_
類型:size_t
buffer 中指定之結果緩衝區的大小 (以位元組為單位)。 buffer   _Out_writes_bytes_to_opt_(bufferSize, *bufferUsed)
類型:void*
指向結果緩衝區的指標。 bufferUsed   _Out_opt_
類型:size_t*
選擇性。包含寫入 buffer 中指定之結果緩衝區的位元組數目的指標。此值定義為非同步提供者在叫用 XAsyncComplete 時所指定之 requiredResultSize 參數的值。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼清單,請參閱錯誤碼。

備註

如果非同步呼叫具有資料承載,請叫用此函式以傳回資料承載。如果非同步呼叫沒有資料承載,則不需要叫用此函式。如果對沒有資料承載的非同步呼叫叫用此函式,函式會傳回錯誤碼 E_NOT_SUPPORTED。 如果為此非同步呼叫的 XAsyncBegin 函式之 identity 參數指定了值,則也必須為此函式的 identity 參數提供相同的值。否則會發生呼叫不相符的情況,且函式會傳回錯誤碼 E_INVALIDARG。 此函式完成且結果已傳回至 buffer 中指定的結果緩衝區之後,asyncBlock 中指定的 XAsyncBlock 即告完成,且不再與該非同步呼叫相關聯。

需求

標頭: XAsyncProvider.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XAsyncProvider 成員
XAsyncBegin
XAsyncComplete
非同步程式設計模型
Last modified on October 6, 2026