Skip to main content

AsyncProviderData

代表傳遞給非同步提供者之回呼函式的資料。

語法

成員

async
類型:XAsyncBlock*
指向保存非同步呼叫資料之 XAsyncBlock 的指標。 bufferSize
類型:size_t
buffer 中指定之結果緩衝區的大小 (以位元組為單位)。只有在以 XAsyncOp::GetResult 作業代碼呼叫回呼函式時,此值才有效,且此值會等於或大於對應 XAsyncComplete 函式呼叫之 requiredBufferSize 參數所指定的值。 buffer
類型:void*
指向回呼函式之結果緩衝區的指標。只有在以 XAsyncOp::GetResult 作業代碼呼叫回呼函式時,此值才有效。 context
類型:void*
呼叫 XAsyncBegin 時傳遞給回呼函式的內容指標。

備註

此結構代表傳遞給非同步提供者之回呼函式的資料。此結構中的資料在每次呼叫回呼函式時都可能變更。回呼函式會被重複呼叫,以執行由每次呼叫所指定之 XAsyncOp 作業代碼決定的非同步工作,而此結構中的資料也可能隨每次呼叫而變更。buffer 和 bufferSize 的值只有在以 XAsyncOp::GetResult 作業代碼呼叫回呼函式時才有效。context 的值在以任何作業代碼呼叫回呼函式時都有效,但只有在以 XAsyncOp::Cleanup 作業代碼呼叫回呼函式時才應釋放。 如需在為 XAsyncOp 中的 GetResult 和 Cleanup 作業代碼執行非同步工作時與 XAsyncProviderData 互動的回呼函式範例,請參閱非同步程式設計模型中的「非同步程式庫」一節。

需求

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

另請參閱

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