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
非同步程式設計模型
