> ## 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.

# PFEventsWriteEventsAsync

> 將以實體為基礎的事件批次寫入 PlayStream。事件的命名空間必須是 'custom' 或以 'custom.' 開頭。

將以實體為基礎的事件批次寫入 PlayStream。事件的命名空間必須是 'custom' 或以 'custom.' 開頭。

## 語法

```cpp theme={null}
HRESULT PFEventsWriteEventsAsync(  
    PFEntityHandle entityHandle,  
    const PFEventsWriteEventsRequest* request,  
    XAsyncBlock* async  
)  
```

### 參數

**`entityHandle`**   PFEntityHandle

用於驗證的 PFEntityHandle。

**`request`**   [PFEventsWriteEventsRequest\*](/zh-TW/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest)

已填入的要求物件。

**`async`**   XAsyncBlock\*<br />*Inout*

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 適用於所有平台。非同步工作完成時，請呼叫 [PFEventsWriteEventsGetResultSize](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresultsize) 和 [PFEventsWriteEventsGetResult](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresult) 以取得結果。

## 需求

**標頭：** PFEvents.h

## 另請參閱

[PFEvents 成員](/zh-TW/services/playfab/api-references/c/pfevents/pfevents_members)


## Related topics

- [PFEventsWriteEventsGetResult](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsgetresult.md)
- [服務 C API 概觀 - PFEvents.h](/zh-TW/services/playfab/api-references/c/pfevents/pfevents_members.md)
- [Write Events](/api-reference/playstream-events/write-events.md)
- [PFEventsWriteTelemetryEventsAsync](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsasync.md)
- [PFEventsWriteTelemetryEventsGetResult](/zh-TW/services/playfab/api-references/c/pfevents/functions/pfeventswritetelemetryeventsgetresult.md)