JoyGetDevCaps: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K
K
Zeile 9: Zeile 9:
  
  
===Parameter===
+
==Parameter==
  
 
''uJoyID [Übergabe]''
 
''uJoyID [Übergabe]''
Zeile 32: Zeile 32:
 
:Die Länge der übergebenen [[JOYCAPS]]-Struktur in Byte.
 
:Die Länge der übergebenen [[JOYCAPS]]-Struktur in Byte.
  
===Rückgabewert(e)===
+
==Rückgabewert(e)==
  
 
Die joyGetDevCaps-Funktion gibt JOYERR_NOERROR = 0 zurück, wenn der Aufruf erfolgreich war. Mögliche andere Rückgabewerte sind:
 
Die joyGetDevCaps-Funktion gibt JOYERR_NOERROR = 0 zurück, wenn der Aufruf erfolgreich war. Mögliche andere Rückgabewerte sind:
Zeile 41: Zeile 41:
  
  
===Sonstige Hinweise===
+
==Sonstige Hinweise==
 
* Unter Windows 9x/ME ist es nicht zwingend notwendig, dass uSize den korrekten Wert für die Länge der [[JOYCAPS]]-Struktur enthält, unter Windows NT/2000/XP/Vista ist es notwendig, da die Funktion ansonsten versagt.
 
* Unter Windows 9x/ME ist es nicht zwingend notwendig, dass uSize den korrekten Wert für die Länge der [[JOYCAPS]]-Struktur enthält, unter Windows NT/2000/XP/Vista ist es notwendig, da die Funktion ansonsten versagt.
  
Zeile 47: Zeile 47:
  
  
===Beispiel===
+
==Beispiel==
  
 
<vb>Dim JC As JOYCAPS
 
<vb>Dim JC As JOYCAPS
Zeile 58: Zeile 58:
  
  
===Verwandte Funktionen===
+
==Verwandte Funktionen==
  
 
* [[joyConfigChanged]] - Weist den Joystick-Treiber an, geänderte Informationen zu aktualisieren<br />
 
* [[joyConfigChanged]] - Weist den Joystick-Treiber an, geänderte Informationen zu aktualisieren<br />
Zeile 70: Zeile 70:
 
* [[joySetThreshold]] - Setzt die Bewegungsschelle eines Joysticks, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben
 
* [[joySetThreshold]] - Setzt die Bewegungsschelle eines Joysticks, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben
  
===Verweise===
+
==Verweise==
  
 
[http://msdn2.microsoft.com/en-us/library/ms709350.aspx MSDN Library - joyGetDevCaps]
 
[http://msdn2.microsoft.com/en-us/library/ms709350.aspx MSDN Library - joyGetDevCaps]
  
  
===Quellen===
+
==Quellen==
  
 
[http://msdn2.microsoft.com/en-us/library/ms709350.aspx MSDN Library - joyGetDevCaps]
 
[http://msdn2.microsoft.com/en-us/library/ms709350.aspx MSDN Library - joyGetDevCaps]

Version vom 15. Mai 2008, 17:26 Uhr


Diese Funktion fragt die Eigenschaften eines angeschlossenen Joysticks ab und gibt diese zurück.

<vb>Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _

			       ByVal uJoyID As Long, _
			       ByRef lpCaps As JOYCAPS, _
			       ByVal uSize As Long) As Long</vb>


Parameter

uJoyID [Übergabe]

Eine Nummer, die den abzufragenden Joystick bestimmt. Unter Windows NT 4.0 sind folgenden Werte möglich:

<vb>Const JOYSTICKID1 = 0 Const JOYSTICKID2 = 1</vb>

Auf neueren Systemen sind Werte zwischen

<vb>Const JOYSTICKID1 = 0</vb>

und

<vb>Const JOYSTICKID16 = 15</vb>

möglich.


lpCaps [Übergabe]

Ein Zeiger auf eine JOYCAPS-Struktur, die die ermittelten Werte erhält.


uSize [Übergabe]

Die Länge der übergebenen JOYCAPS-Struktur in Byte.

Rückgabewert(e)

Die joyGetDevCaps-Funktion gibt JOYERR_NOERROR = 0 zurück, wenn der Aufruf erfolgreich war. Mögliche andere Rückgabewerte sind:

<vb>Const MMSYSERR_BASE = 0 Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6) Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)</vb>


Sonstige Hinweise

  • Unter Windows 9x/ME ist es nicht zwingend notwendig, dass uSize den korrekten Wert für die Länge der JOYCAPS-Struktur enthält, unter Windows NT/2000/XP/Vista ist es notwendig, da die Funktion ansonsten versagt.
  • Unter Windows 9x/ME wird MMSYSERR_INVALIDPARAM zurückgegeben, wenn der Parameter id ungültig ist. Unter Windows NT/2000/XP wird in diesem Falle MMSYSERR_NODRIVER zurückgegeben.


Beispiel

<vb>Dim JC As JOYCAPS

ret = joyGetDevCaps(JOYSTICKID1, JC, Len(JC))

If ret <> JOYERR_NOERROR Then

  ' Fehler beim Aufruf

End If</vb>


Verwandte Funktionen

  • joyConfigChanged - Weist den Joystick-Treiber an, geänderte Informationen zu aktualisieren
  • joyGetDevCaps - Fragt Informationen über den Joystick ab
  • joyGetNumDevs - Gibt die Anzahl unterstützter Joysticks zurück
  • joyGetPos - Fragt die Positionsdaten eines Joysticks ab
  • joyGetPosEx - Fragt die Positionsdaten eines Joysticks ab
  • joyGetThreshold - Gibt die Bewegunsschwelle zurück, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben
  • joyReleaseCapture - Gibt ein Capture auf einen Joystick wieder frei
  • joySetCapture - Setzt ein Capture auf einen Joystick, sodass Informationen per Fenster-Nachricht empfangen werden
  • joySetThreshold - Setzt die Bewegungsschelle eines Joysticks, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben

Verweise

MSDN Library - joyGetDevCaps


Quellen

MSDN Library - joyGetDevCaps