Wersje XInput

XInput to międzyplatformowy interfejs API dostarczany do użytku na konsolach Xbox i Windows. Na konsoli Xbox XInput jest dostarczana jako biblioteka statyczna, która jest kompilowana w głównym pliku wykonywalnym gry. W systemie Windows XInput jest dostarczany jako biblioteka DLL zainstalowana w folderach systemowych systemu operacyjnego.

Obecnie istnieją trzy bieżące wersje biblioteki DLL XInput. Wybierz odpowiednią wersję środowiska XInput na podstawie funkcji używanego środowiska XInput i wersji systemu Windows, które mają być obsługiwane.

• XInput 1.4: XInput 1.4 jest dostarczany w ramach systemu Windows 10. Użyj tej wersji do tworzenia aplikacji platformy UWP.
• XInput 9.1.0: XInput 9.1.0 jest dostarczany jako część systemów Windows Vista, Windows 7 i Windows 8. Użyj tej wersji, jeśli aplikacja klasyczna ma być uruchamiana w tych wersjach systemu Windows i używasz podstawowych funkcji XInput.
• XInput 1.3: XInput 1.3 jest dostarczany jako składnik redystrybucyjny w zestawie SDK DirectX z obsługą systemów Windows Vista, Windows 7 i Windows 8. Użyj tej wersji, jeśli aplikacja klasyczna ma działać w tych wersjach systemu Windows i potrzebujesz funkcji, które nie są obsługiwane przez program XInput 9.1.0.

XInput 1.4

XInput 1.4 jest obecnie dostarczany jako składnik systemowy w systemie Windows 8 jako XINPUT1_4.DLL. Jest dostępna "skrzynka odbiorcza" i nie wymaga ponownej dystrybucji z aplikacją. Zestaw Windows Software Development Kit (SDK) zawiera nagłówek i bibliotekę importu do statycznego łączenia z XINPUT1_4.DLL. Aby pobrać zestaw SDK systemu Windows 8, zobacz Pliki do pobrania na potrzeby tworzenia aplikacji klasycznych.

XInput 1.4 ma te podstawowe zalety w porównaniu z innymi wersjami XInput:

• Jest to jedyna wersja, która może być używana w aplikacjach C++/DirectX ze Sklepu Windows.
• Nowa funkcja XInputGetAudioDeviceIds udostępnia ciąg identyfikatora urządzenia audio, którego można użyć do otwarcia głosu lub audio XAudio2 dla zestawu słuchawkowego dołączonego do kontrolera. Funkcja XInputGetDSoundAudioDeviceGuids nie jest dostępna w tej wersji.
• Zapewnia ulepszone funkcje raportowania urządzeń, w tym XINPUT_CAPS_WIRELESS, XINPUT_CAPS_FFB_SUPPORTED, XINPUT_CAPS_PMD_SUPPORTED i flagi XINPUT_CAPS_NO_NAVIGATION oraz dokładniejsze raportowanie XINPUT_CAPS_VOICE_SUPPORTED. Te flagi są łączone w Flags składowej struktury XINPUT_CAPABILITIES. Funkcja XInputGetCapabilities zwraca XINPUT_CAPABILITIES.

XInput 9.1.0

Podobnie jak XInput 1.4, XInput 9.1.0 jest obecnie dostarczany jako składnik systemu w systemie Windows 10, Windows 8.x, Windows 7 i Windows Vista jako XINPUT9_1_0.DLL. Jest on utrzymywany głównie w celu zapewnienia zgodności z poprzednimi wersjami istniejących aplikacji. Ma on ograniczony zestaw funkcji, dlatego zalecamy użycie protokołu XInput 1.4, jeśli jest to możliwe. Jednak jest to wygodne w przypadku aplikacji, które muszą działać w starszych wersjach systemu Windows, ale nie wymagają dodatkowej funkcjonalności audio zapewnianej przez XInput 1.4 lub XInput 1.3.

Zestaw Windows SDK zawiera nagłówek i bibliotekę importu do statycznego łączenia z XINPUT9_1_0.DLL.

XInput 9.1.0 ma te wady w innych wersjach XInput:

• Ze względów zgodności z poprzednimi wersjami XInputGetCapabilities w tej wersji XInput zwraca stałe informacje o możliwości. Niezależnie od dołączonego urządzenia kontrolera XInputGetCapabilities w programie XInput 9.1.0 zawsze będzie zgłaszać podtyp urządzenia GAMEPAD. Nie zwróci XINPUT_CAPS_WIRELESS możliwości bitu, nawet jeśli urządzenie bezprzewodowe jest podłączone.
• Nie można określić zestawu słuchawkowego dla danego identyfikatora użytkownika. Funkcja XInputGetAudioDeviceIds jest niedostępna i XInputGetDSoundAudioDeviceGuids funkcja nie zwróci żadnych wyników w systemie Windows 8.x lub Windows 10.
• FunkcjeXInputEnable, XInputGetBatteryInformationi XInputGetKeystroke nie są dostępne.

XInput 1.3

Niektóre poprzednie wersje interfejsu XInput zostały udostępnione jako biblioteki DLL redystrybucyjne w zestawie SDK DirectX. Pierwsza wersja redystrybucyjna XInput, XInput 1.1, wydana w kwietniu 2006 r. zestawu SDK DirectX. Ostatnia wersja do wysłania w zestawie SDK DirectX to XInput 1.3, która jest dostępna w wersji starszej wersji zestawu DirectX SDK z czerwca 2010 r. zestaw SDK DirectX nie jest już dostępny w witrynie Microsoft Downloads.

Można użyć XInput 1.3 dla aplikacji, które obsługują wersje systemu Windows na poziomie podrzędnym i wymagają funkcji, które nie są udostępniane przez XInput 9.1.0 (czyli poprawne raportowanie podtypów, obsługa audio, jawna obsługa raportowania baterii itd.).