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

# XAppBroadcastGetStatus

> XAppBroadcastGetStatus

# XAppBroadcastGetStatus

擷取裝置和目前應用程式的目前廣播狀態。

## 語法

```cpp theme={null}
HRESULT XAppBroadcastGetStatus(  
         XUserHandle requestingUser,  
         XAppBroadcastStatus* appBroadcastStatus  
)  
```

### 參數

*requestingUser*   \_In\_\
類型：XUserHandle

要求廣播狀態之使用者的控制代碼。

*appBroadcastStatus*   \_Out\_\
類型：[XAppBroadcastStatus\*](/zh-TW/reference/system/xappcapture/structs/xappbroadcaststatus)

*requestingUser* 的廣播狀態。

### 傳回值

類型：HRESULT

函式結果。

## 備註

<Note>在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

使用此函式來判斷您是否可以開始廣播您的遊戲。擷取廣播狀態也可能揭露您無法廣播時的原因。建議您在呼叫 [XAppBroadcastShowUI](/zh-TW/reference/system/xappcapture/functions/xappbroadcastshowui) 方法之前先呼叫此函式。
如果您想查看您的遊戲目前是否正在廣播，請呼叫 [XAppBroadcastIsAppBroadcasting](/zh-TW/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting)。

## 需求

**標頭：** XAppCapture.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[GameDVR 概觀](/zh-TW/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture 成員](/zh-TW/reference/system/xappcapture/xappcapture_members)\
[XAppBroadcastShowUI](/zh-TW/reference/system/xappcapture/functions/xappbroadcastshowui)\
[XAppBroadcastIsAppBroadcasting](/zh-TW/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting)


## Related topics

- [XAppBroadcastGetStatus](/reference/system/xappcapture/functions/xappbroadcastgetstatus.md)
- [XAppBroadcastStatus](/reference/system/xappcapture/structs/xappbroadcaststatus.md)