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

# XAppBroadcastGetStatus

> XAppBroadcastGetStatus

# XAppBroadcastGetStatus

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

## 語法

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

### 參數

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

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

*appBroadcastStatus*   \_Out\_\
類型：[XAppBroadcastStatus\*](https://docs.xbox.com/zh-TW/reference/system/xappcapture/structs/xappbroadcaststatus.md)

*requestingUser* 的廣播狀態。

### 傳回值

類型：HRESULT

函式結果。

## 備註

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

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

## 需求

**標頭：** 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 概觀](https://docs.xbox.com/zh-TW/build/console-features/game-dvr/gamedvr-broadcast.md)\
[XAppCapture 成員](https://docs.xbox.com/zh-TW/reference/system/xappcapture/xappcapture_members.md)\
[XAppBroadcastShowUI](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappbroadcastshowui.md)\
[XAppBroadcastIsAppBroadcasting](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting.md)


## Related topics

- [XAppBroadcastStatus](https://docs.xbox.com/zh-TW/reference/system/xappcapture/structs/xappbroadcaststatus.md)
- [XAppBroadcastIsAppBroadcasting](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting.md)
- [XAppBroadcastShowUI](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappbroadcastshowui.md)
- [Game DVR 與廣播](https://docs.xbox.com/zh-TW/build/console-features/game-dvr/gamedvr-broadcast.md)
- [XAppCapture (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xappcapture/xappcapture_members.md)