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

Retrieves the current status for broadcasting for the device and current app.

## Syntax

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

### Parameters

*requestingUser*   \_In\_\
Type: XUserHandle

Handle for the user requesting a broadcast status.

*appBroadcastStatus*   \_Out\_\
Type: [XAppBroadcastStatus\*](/reference/system/xappcapture/structs/xappbroadcaststatus)

The broadcast status of the *requestingUser*.

### Return value

Type: HRESULT

Function result.

## Remarks

<Note>This function isn't safe to call on a time-sensitive thread. For more information, see [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Use this function to determine whether or not you can start broadcasting for your game. Retrieving the broadcast status may also reveal the reason you are unable to broadcast in the event you are not able to. It is recommended you call this function before calling the [XAppBroadcastShowUI](/reference/system/xappcapture/functions/xappbroadcastshowui) method.
If you would like to see whether your game is currently broadcasting call [XAppBroadcastIsAppBroadcasting](/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting).

## Requirements

**Header:** XAppCapture.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## Conceptual documentation

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[GameDVR Overview](/build/console-features/game-dvr/gamedvr-broadcast)\
[XAppCapture Members](/reference/system/xappcapture/xappcapture_members)\
[XAppBroadcastShowUI](/reference/system/xappcapture/functions/xappbroadcastshowui)\
[XAppBroadcastIsAppBroadcasting](/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting)


## Related topics

- [XAppBroadcastStatus](/reference/system/xappcapture/structs/xappbroadcaststatus.md)
- [XAppBroadcastIsAppBroadcasting](/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting.md)
- [XAppBroadcastShowUI](/reference/system/xappcapture/functions/xappbroadcastshowui.md)
- [Game DVR and broadcasting](/build/console-features/game-dvr/gamedvr-broadcast.md)
- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)