JoyGetDevCaps: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
(Seite wurde an die Format-Vorlage angepasst, Hinweise ergänzt)
Zeile 11: Zeile 11:
  
  
===Parameter:===
+
===Parameter===
  
 
''id [Übergabe]''
 
''id [Übergabe]''
Zeile 22: Zeile 22:
 
''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.
  
  
Zeile 30: Zeile 30:
  
  
===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.
  
 +
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:===
+
 
 +
===Beispiel===
  
 
<code vb>
 
<code vb>
Zeile 58: Zeile 61:
  
  
===Verweise:===
+
===Verweise===
 +
 
 +
[http://msdn2.microsoft.com/en-us/library/ms709350.aspx MSDN Library - joyGetDevCaps]
 +
 
 +
 
 +
===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]
 +
  
 
[[Kategorie:Eingabegeräte]]
 
[[Kategorie:Eingabegeräte]]

Version vom 13. April 2008, 14:43 Uhr


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

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


Parameter

id [Übergabe]

Eine Nummer, die den abzufragenden Joystick bestimmt. Die folgenden Werte sind möglich:
Const JOYSTICKID1 = 0

Const JOYSTICKID2 = 1


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


Verweise

MSDN Library - joyGetDevCaps


Quellen

MSDN Library - joyGetDevCaps