XAsyncGetResult
非同期プロバイダーからの非同期呼び出しの結果を返します。Syntax
Parameters
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 パラメーターの値として定義されます。
Return value
型: HRESULT 成功した場合はS_OK を返します。それ以外の場合はエラー コードを返します。エラー コードの一覧については、Error Codes を参照してください。
Remarks
非同期呼び出しにデータ ペイロードがある場合は、この関数を呼び出してデータ ペイロードを返します。非同期呼び出しにデータ ペイロードがない場合は、この関数を呼び出す必要はありません。この関数がデータ ペイロードを持たない非同期呼び出しに対して呼び出された場合、関数はエラー コードE_NOT_SUPPORTED を返します。
この非同期呼び出しの XAsyncBegin 関数の identity パラメーターに値が指定されていた場合は、この関数の identity パラメーターにも同じ値を指定する必要があります。それ以外の場合、呼び出しの不一致が発生し、関数はエラー コード E_INVALIDARG を返します。
この関数が完了し、結果が buffer に指定された結果バッファーに返された後、asyncBlock に指定された XAsyncBlock は完了し、非同期呼び出しには関連付けられなくなります。
Requirements
ヘッダー: XAsyncProvider.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XAsyncProvider MembersXAsyncBegin
XAsyncComplete
Asynchronous Programming Model