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

# XGameUiSetNotificationPositionHint

> XGameUiSetNotificationPositionHint

# XGameUiSetNotificationPositionHint

設定目前遊戲上顯示快顯通知的慣用位置。

## 語法

```cpp theme={null}
HRESULT XGameUiSetNotificationPositionHint(  
         XGameUiNotificationPositionHint position  
)  
```

### 參數

*position*   \_In\_\
類型：[XGameUiNotificationPositionHint](/zh-TW/reference/system/xgameui/enums/xgameuinotificationpositionhint)

表示在目前遊戲上顯示快顯通知的慣用位置。

### 傳回值

類型：HRESULT

## 備註

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

通知位置是提供給作業系統的提示，說明要在何處顯示快顯通知。在某些情況下，如果目前的 UI 無法支援在該位置顯示通知，系統可能會選擇忽略此設定。在 XBOX 上，快顯通知預設會顯示在畫面底部中央。

此 API 存在於 Windows 上，但目前對成就及其他快顯通知沒有作用。

## 需求

**標頭：** XGameUI.h

**程式庫：** xgameruntime.lib

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

## 概念文件

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

## 另請參閱

[XGameUI](/zh-TW/reference/system/xgameui/xgameui_members)\
[XGameUiNotificationPositionHint](/zh-TW/reference/system/xgameui/enums/xgameuinotificationpositionhint)


## Related topics

- [XGameUiSetNotificationPositionHint](/reference/system/xgameui/functions/xgameuisetnotificationpositionhint.md)
- [XGameUiNotificationPositionHint](/reference/system/xgameui/enums/xgameuinotificationpositionhint.md)