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

# PFEventPipelineCreatePlayStreamPipelineHandle

> 建立使用 Entity 來上傳 PlayStream 事件的事件管線。

建立使用 Entity 來上傳 PlayStream 事件的事件管線。

## 語法

```cpp theme={null}
HRESULT PFEventPipelineCreatePlayStreamPipelineHandle(  
    PFEntityHandle entityHandle,  
    XTaskQueueHandle queue,  
    PFEventPipelineBatchUploadSucceededEventHandler* eventPipelineBatchUploadedEventHandler,  
    PFEventPipelineBatchUploadFailedEventHandler* eventPipelineBatchFailedEventHandler,  
    void* handlerContext,  
    PFEventPipelineHandle* eventPipelineHandle  
)  
```

### 參數

**`entityHandle`**   PFEntityHandle

其權杖將用於在背景中發出 PlayFab 服務要求的 Entity。

**`queue`**   XTaskQueueHandle<br />*optional*

將排程背景工作並叫用事件回呼的非同步佇列。

**`eventPipelineBatchUploadedEventHandler`**   PFEventPipelineBatchUploadSucceededEventHandler\*<br />*optional*

上傳一批事件時將叫用的選用處理常式。

**`eventPipelineBatchFailedEventHandler`**   PFEventPipelineBatchUploadFailedEventHandler\*<br />*optional*

上傳一批事件失敗時將叫用的選用處理常式。

**`handlerContext`**   void\*<br />*optional*

事件處理常式所使用資料的選用指標。

**`eventPipelineHandle`**   PFEventPipelineHandle\*<br />*output*

所建立管線的控制代碼。不再需要時，必須使用 PFEventPipelineCloseHandle 將其關閉。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。可能的值為 S\_OK、E\_INVALIDARG、E\_PF\_NOT\_INITIALIZED 或 E\_FAIL。

## 需求

**標頭：** PFEventPipeline.h

## 另請參閱

[PFEventPipeline 成員](/zh-TW/services/playfab/api-references/c/pfeventpipeline/pfeventpipeline_members)


## Related topics

- [服務 C API 概觀 - PFEventPipeline.h](/zh-TW/services/playfab/api-references/c/pfeventpipeline/pfeventpipeline_members.md)
- [PlayFab Services SDK - 事件管線](/zh-TW/services/playfab/sdks/c/event-pipeline/eventpipeline.md)
- [PFEventPipelineCreateTelemetryPipelineHandleWithKey](/zh-TW/services/playfab/api-references/c/pfeventpipeline/functions/pfeventpipelinecreatetelemetrypipelinehandlewithkey.md)
- [PFEventPipelineCreateTelemetryPipelineHandleWithEntity](/zh-TW/services/playfab/api-references/c/pfeventpipeline/functions/pfeventpipelinecreatetelemetrypipelinehandlewithentity.md)
- [PFEventPipelineDuplicateHandle](/zh-TW/services/playfab/api-references/c/pfeventpipeline/functions/pfeventpipelineduplicatehandle.md)