XInputGetCapabilities 函式 ()

  • 發行項

擷取連線控制器的功能和功能。

語法

DWORD XInputGetCapabilities(
  [in]  DWORD               dwUserIndex,
  [in]  DWORD               dwFlags,
  [out] XINPUT_CAPABILITIES *pCapabilities
);

參數

[in] dwUserIndex

使用者控制器的索引。 可以是範圍 0-3 中的值。 如需如何決定此值以及如何將值對應至控制器上指標的資訊，請參閱 多個控制器。

[in] dwFlags

識別控制器類型的輸入旗標。 如果此值為 0，則會傳回所有連線至系統之控制器的功能。 目前僅支援一個值：

值 Description
XINPUT_FLAG_GAMEPAD 將查詢限制為控制器類型的裝置。
 

上述或 0 以外的 任何 dwflags 值不合法，而且會在偵錯時造成錯誤中斷。

[out] pCapabilities

接收控制器功能的 XINPUT_CAPABILITIES 結構的指標。

傳回值

如果函式成功，傳回值會 ERROR_SUCCESS。

如果控制器未連接，傳回值會 ERROR_DEVICE_NOT_CONNECTED。

如果函式失敗，傳回值是 WinError.h 中定義的錯誤碼。 函式不會使用 SetLastError 來設定呼叫執行緒的最後一個錯誤碼。

備註

注意 Windows Vista 和更新 (版本中隨附的舊版一律會傳回一組固定功能，而不論連接的裝置為何，Windows Vista 和更新版本) 一律會傳回一組固定的功能。
 

平臺需求

Windows 8 (XInput 1.4) 、DirectX SDK (XInput 1.3) 、Windows Vista (XInput 9.1.0)

規格需求

   
目標平台 Windows
標頭 xinput.h
程式庫 一般Xinput9_1_0.lib
Dll Xinput1_4.dll;Xinput9_1_0.dll

另請參閱

XInput 函式

XInputGetState

XInputSetState