Skip to main content

IGameInput::RegisterSystemButtonCallback

註冊在按下或放開指南或分享按鈕時呼叫的回呼函式。

語法

參數

device   _In_opt_
類型:IGameInputDevice*
可選擇性地將已註冊的回呼限制為針對特定裝置觸發。 buttonFilter   _In_
類型:GameInputSystemButtons
要接收回呼的按鈕集合,以邏輯 OR 結合在一起。 context   _In_opt_
類型:void*
為回呼函式提供相關資訊的物件。通常是呼叫端物件。 callbackFunc   _In_
類型:GameInputSystemButtonCallback
在按下或放開系統按鈕時呼叫的遊戲定義回呼函式。 callbackToken   _Out_opt_
類型:GameInputCallbackToken*
識別已註冊回呼函式的權杖。當您需要取消或取消註冊回呼函式時,會使用此權杖來識別已註冊的函式。

傳回值

類型:HRESULT 函式結果。

備註

此方法會註冊在按下或放開指南或系統按鈕時呼叫的回呼函式。是否會分派回呼,取決於您的處理序與其他處理序中由 IGameInput::SetFocusPolicy 設定的 GameInputFocusPolicy。如需詳細資料,請參閱 GameInputFocusPolicy。在 XBOX 上,殼層一律會取用指南按鈕,因此這些回呼永遠不會在 XBOX 上分派。 若要停止接收回呼,請參閱 IGameInput::UnregisterCallback 和 IGameInput::StopCallback 方法。 此功能已新增至 Windows SDK 10.0.26031 預覽版的 GameInput.h,並將在未來的 GDK 版本中加入。 下列程式碼範例示範如何接聽指南按鈕的按下動作。

需求

標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInput 進階主題
GameInput 概觀
IGameInput

版本歷程記錄

Last modified on October 6, 2026