JoyGetDevCaps: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K (Parameter)
K (vb-Tags ergänzt)
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 vb>
+
<vb>
 
  Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _
 
  Declare Function joyGetDevCaps Lib "winmm.dll" Alias "joyGetDevCapsA" ( _
 
        ByVal uJoyID As Long, _
 
        ByVal uJoyID As Long, _
 
        ByRef lpCaps As JOYCAPS, _
 
        ByRef lpCaps As JOYCAPS, _
 
        ByVal uSize As Long) As Long
 
        ByVal uSize As Long) As Long
</code>
+
</vb>
  
  
Zeile 16: Zeile 16:
  
 
:Eine Nummer, die den abzufragenden Joystick bestimmt. Unter Windows NT 4.0 sind folgenden Werte möglich:
 
:Eine Nummer, die den abzufragenden Joystick bestimmt. Unter Windows NT 4.0 sind folgenden Werte möglich:
:<code vb>
+
:<vb> Const JOYSTICKID1 = 0
Const JOYSTICKID1 = 0
 
 
  Const JOYSTICKID2 = 1</code>
 
  Const JOYSTICKID2 = 1</code>
 
:Auf neueren Systemen sind Werte zwischen  
 
:Auf neueren Systemen sind Werte zwischen  
  <code vb> Const JOYSTICKID1 = 0</code>  
+
  <vb> Const JOYSTICKID1 = 0</vb>  
 
:und  
 
:und  
  <code vb> Const JOYSTICKID16 = 15</code>
+
  <vb> Const JOYSTICKID16 = 15</vb>
 
:möglich.
 
:möglich.
  
Zeile 39: Zeile 38:
 
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 vb>
+
<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)
</code>
+
</vb>
  
  
Zeile 54: Zeile 52:
 
===Beispiel===
 
===Beispiel===
  
<code vb>
+
<vb>
 
  Dim JC As JOYCAPS
 
  Dim JC As JOYCAPS
 
   
 
   
Zeile 62: Zeile 60:
 
     ' Fehler beim Aufruf
 
     ' Fehler beim Aufruf
 
  End If
 
  End If
</code>
+
</vb>
  
  

Version vom 13. Mai 2008, 15:14 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</code>
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