> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AsyncProviderData

> AsyncProviderData

# AsyncProviderData

비동기 공급자의 콜백 함수에 전달되는 데이터를 나타냅니다.

## 구문

```cpp theme={null}
typedef struct XAsyncProviderData {  
    XAsyncBlock* async;  
    size_t bufferSize;  
    void* buffer;  
    void* context;  
} XAsyncProviderData  
```

### 멤버

*async*\
형식: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

비동기 호출을 위한 데이터를 보유하는 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)에 대한 포인터입니다.

*bufferSize*\
형식: size\_t

*buffer*에 지정된 결과 버퍼의 크기(바이트)입니다. 이 값은 콜백 함수가 [XAsyncOp::GetResult](/reference/system/xasyncprovider/enums/xasyncop) 작업 코드로 호출될 때만 유효하며, 값은 해당 [XAsyncComplete](/reference/system/xasyncprovider/functions/xasynccomplete) 함수 호출의 *requiredBufferSize* 매개 변수에 지정된 값 이상이 됩니다.

*buffer*\
형식: void\*

콜백 함수의 결과 버퍼에 대한 포인터입니다. 이 값은 콜백 함수가 [XAsyncOp::GetResult](/reference/system/xasyncprovider/enums/xasyncop) 작업 코드로 호출될 때만 유효합니다.

*context*\
형식: void\*

[XAsyncBegin](/reference/system/xasyncprovider/functions/xasyncbegin)이 호출되었을 때 콜백 함수에 전달된 컨텍스트 포인터입니다.

## 설명

이 구조체는 비동기 공급자의 콜백 함수에 전달되는 데이터를 나타냅니다. 이 구조체의 데이터는 콜백 함수가 호출될 때마다 변경될 수 있습니다. 콜백 함수는 각 호출에 대해 지정된 [XAsyncOp](/reference/system/xasyncprovider/enums/xasyncop) 작업 코드에 의해 결정되는 비동기 작업을 수행하기 위해 반복적으로 호출되며, 이 구조체의 데이터도 각 호출마다 변경될 수 있습니다. *buffer* 및 *bufferSize*의 값은 콜백 함수가 `XAsyncOp::GetResult` 작업 코드로 호출될 때만 유효합니다. *context* 값은 콜백 함수가 어떤 작업 코드로 호출되든 유효하지만, 콜백 함수가 `XAsyncOp::Cleanup` 작업 코드로 호출될 때만 해제해야 합니다.

`XAsyncOp`의 `GetResult` 및 `Cleanup` 작업 코드에 대한 비동기 작업을 수행할 때 `XAsyncProviderData`와 상호 작용하는 콜백 함수의 예제는 [비동기 프로그래밍 모델](/build/core-features/common/async/async-programming-model#heading-7)의 "Async Library" 섹션을 참조하세요.

## 요구 사항

**헤더:** XAsyncProvider.h

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XAsyncProvider 멤버](/reference/system/xasyncprovider/xasyncprovider_members)\
[XAsyncComplete](/reference/system/xasyncprovider/functions/xasynccomplete)\
[XAsyncBegin](/reference/system/xasyncprovider/functions/xasyncbegin)\
[XAsyncOp](/reference/system/xasyncprovider/enums/xasyncop)\
[비동기 프로그래밍 모델](/build/core-features/common/async/async-programming-model)


## Related topics

- [XAsyncProvider](/ko/reference/system/xasyncprovider/xasyncprovider_members.md)
- [XAsyncProvider function](/ko/reference/system/xasyncprovider/functions/xasyncprovider.md)
- [XAsyncBegin](/ko/reference/system/xasyncprovider/functions/xasyncbegin.md)
- [XAsyncOp](/ko/reference/system/xasyncprovider/enums/xasyncop.md)
- [AuthenticationProvider](/ko/services/playfab/api-references/events/data-types/authenticationprovider.md)