JoyGetDevCaps: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: __NOTOC__ Diese Funktion fragt die Eigenschaften eines angeschlossenen Joysticks ab und gibt diese zurück. <code> Declare Function joyGetDevCaps Lib "winmm.dll" Alia...)
 
 
(20 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
 
Diese Funktion fragt die Eigenschaften eines angeschlossenen Joysticks ab und gibt diese zurück.
 
Diese Funktion fragt die Eigenschaften eines angeschlossenen Joysticks ab und gibt diese zurück.
  
−
<code>
+
<syntaxhighlight lang="vb">Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _
−
Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _
+
      ByVal uJoyID As Long, _
−
      ByVal id As Long, _
+
      ByRef lpCaps As JOYCAPS, _
−
      ByVal lpCaps As Long, _
+
      ByVal uSize As Long) As Long</syntaxhighlight>
−
      ByVal uSize As Long) As Long
 
−
</code>
 
  
−
===Parameter:===
 
  
−
''id [Übergabe]''
+
==Parameter==
 +
 
 +
''uJoyID [Übergabe]''
 +
 
 +
:Eine Nummer, die den abzufragenden Joystick bestimmt. Unter Windows NT 4.0 sind folgenden Werte möglich:
 +
<syntaxhighlight lang="vb">Const JOYSTICKID1 = 0
 +
Const JOYSTICKID2 = 1</syntaxhighlight>
 +
:Auf neueren Systemen sind Werte zwischen
 +
<syntaxhighlight lang="vb">Const JOYSTICKID1 = 0</syntaxhighlight>
 +
:und
 +
<syntaxhighlight lang="vb">Const JOYSTICKID16 = 15</syntaxhighlight>
 +
:möglich.
  
−
:Eine Nummer, die den abzufragenden Joystick bestimmt. Die folgenden Werte sind möglich:
 
−
:<code>Const JOYSTICKID1 = 0
 
−
Const JOYSTICKID2 = 1</code>
 
  
 
''lpCaps [Übergabe]''
 
''lpCaps [Übergabe]''
  
−
:Ein Zeiger auf eine [[JOYCAPS]]-Struktur, die die ermittelten Werte erhält
+
:Ein Zeiger auf eine [[JOYCAPS]]-Struktur, die die ermittelten Werte erhält.
 +
 
  
 
''uSize [Übergabe]''
 
''uSize [Übergabe]''
Zeile 26: 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:
  
−
<code>
+
<syntaxhighlight lang="vb">Const MMSYSERR_BASE = 0
−
Const MMSYSERR_BASE = 0
 
 
Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6)
 
Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6)
−
Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)
+
Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)</syntaxhighlight>
−
</code>
 
  
−
===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.
 
  
−
===Beispiel:===
+
==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.
  
−
<code>
+
* 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.
−
Dim JC As JOYCAPS
+
 
 +
 
 +
==Beispiel==
 +
 
 +
<syntaxhighlight lang="vb">Dim JC As JOYCAPS
  
 
ret = joyGetDevCaps(JOYSTICKID1, JC, Len(JC))
 
ret = joyGetDevCaps(JOYSTICKID1, JC, Len(JC))
Zeile 48: Zeile 55:
 
If ret <> JOYERR_NOERROR Then
 
If ret <> JOYERR_NOERROR Then
 
   ' Fehler beim Aufruf
 
   ' Fehler beim Aufruf
−
End If
+
End If</syntaxhighlight>
−
</code>
+
 
 +
 
 +
==Verwandte Funktionen==
 +
 
 +
* [[joyConfigChanged]] - Weist den Joystick-Treiber an, geänderte Informationen zu aktualisieren<br />
 +
* [[joyGetDevCaps]] - Fragt Informationen über den Joystick ab<br />
 +
* [[joyGetNumDevs]] - Gibt die Anzahl unterstützter Joysticks zurück<br />
 +
* [[joyGetPos]] - Fragt die Positionsdaten eines Joysticks ab<br />
 +
* [[joyGetPosEx]] - Fragt die Positionsdaten eines Joysticks ab<br />
 +
* [[joyGetThreshold]] - Gibt die Bewegunsschwelle zurück, ab der Nachrichten an Fenster geschickt werden, die ein Capture auf den Joystick haben<br />
 +
* [[joyReleaseCapture]] - Gibt ein Capture auf einen Joystick wieder frei<br />
 +
* [[joySetCapture]] - Setzt ein Capture auf einen Joystick, sodass Informationen per Fenster-Nachricht empfangen werden<br />
 +
* [[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]
  
−
{{Benutzer:Bernhard Döbler/Vorlage:Zuständig|Henrik Ilgen}}
+
 
 +
==Quellen==
 +
 
 +
[http://msdn2.microsoft.com/en-us/library/ms709350.aspx MSDN Library - joyGetDevCaps]
 +
 
 +
 
 +
[[Kategorie:Eingabegeräte]]
 +
[[Kategorie:Winmm]]
 +
[[Kategorie:Funktionen]]
 +
[[Kategorie:Joystick]]

Aktuelle Version vom 5. November 2016, 23:47 Uhr


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

Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _
 			       ByVal uJoyID As Long, _
 			       ByRef lpCaps As JOYCAPS, _
 			       ByVal uSize As Long) As Long


Parameter

uJoyID [Übergabe]

Eine Nummer, die den abzufragenden Joystick bestimmt. Unter Windows NT 4.0 sind folgenden Werte möglich:
Const JOYSTICKID1 = 0
Const JOYSTICKID2 = 1
Auf neueren Systemen sind Werte zwischen 
Const JOYSTICKID1 = 0
und 
Const JOYSTICKID16 = 15
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: 

Const MMSYSERR_BASE = 0
Const MMSYSERR_NODRIVER = (MMSYSERR_BASE + 6)
Const MMSYSERR_INVALPARAM = (MMSYSERR_BASE + 11)


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

Dim JC As JOYCAPS

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

If ret <> JOYERR_NOERROR Then
   ' Fehler beim Aufruf
End If


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

Abgerufen von „https://activevb.de/cgi-bin/apiwiki/index.php?title=JoyGetDevCaps&oldid=4183“