IGameInput::CreateAggregateDevice

語法

HRESULT CreateAggregateDevice(
         GameInputKind inputKind,
         APP_LOCAL_DEVICE_ID* deviceId
)

參數

inputKind _In_
類型：GameInputKind

傳回的虛擬 IGameInputDevice 將為其彙總讀數的輸入類型。

deviceId _Out_
類型：APP_LOCAL_DEVICE_ID*

產生的彙總裝置之裝置識別碼。

傳回值

類型：HRESULT

函式結果。當使用不支援的 GameInputKind 或嘗試合併 GameInputKind 旗標時，會傳回失敗。

備註

用於 CreateAggregateDevice 的輸入種類必須是 GameInputKind 列舉中的單一值。不支援合併 GameInputKind 旗標。如果應用程式需要多種輸入種類的彙總輸入，則必須為每一種輸入種類建立虛擬 IGameInputDevice 執行個體。

此函式用於重新啟用可能已透過呼叫 DisableAggregateDevice 而停用的彙總裝置。其結果是重新啟用該裝置，而不是建立另一個執行個體。

彙總裝置也會透過呼叫 RegisterDeviceCallback 所註冊的回呼發出狀態通知。

僅下列輸入種類支援彙總：

GameInputKindKeyboard

GameInputKindMouse

GameInputKindArcadeStick

GameInputKindFlightStick

GameInputKindGamepad

GameInputKindRacingWheel

版本	變更
v3	已實作 (先前在 v0 中為 E_NOTIMPL) 並重新推出。簽章已變更：`IGameInputDevice*` 已由 `APP_LOCAL_DEVICE_ID` 取代。
v1	已移除。
v0	已推出但未實作。

版本

變更

已實作 (先前在 v0 中為 E_NOTIMPL) 並重新推出。簽章已變更：IGameInputDevice** 已由 APP_LOCAL_DEVICE_ID* 取代。

已移除。

已推出但未實作。

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

IGameInput::CreateAggregateDevice

語法

參數

傳回值

備註

需求

版本歷程記錄

​IGameInput::CreateAggregateDevice

​語法

​參數

​傳回值

​備註

​需求

​版本歷程記錄

IGameInput::CreateAggregateDevice

語法

參數

傳回值

備註

需求

版本歷程記錄