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

# XAsyncProviderData

> AsyncProviderData

# AsyncProviderData

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

## 구문

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

### 멤버

*async*\
형식: [XAsyncBlock\*](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)

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

*bufferSize*\
형식: size\_t

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

*buffer*\
형식: void\*

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

*context*\
형식: void\*

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

## 설명

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

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

## 요구 사항

**헤더:** XAsyncProvider.h

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

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


## Related topics

- [XAsyncProvider](https://docs.xbox.com/ko/reference/system/xasyncprovider/functions/xasyncprovider.md)
- [XAsyncProvider (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xasyncprovider/xasyncprovider_members.md)
- [XAsyncOp](https://docs.xbox.com/ko/reference/system/xasyncprovider/enums/xasyncop.md)
- [XAsyncBegin](https://docs.xbox.com/ko/reference/system/xasyncprovider/functions/xasyncbegin.md)
- [AuthenticationProvider](https://docs.xbox.com/ko/services/playfab/api-references/events/data-types/authenticationprovider.md)