JoyGetDevCaps: Unterschied zwischen den Versionen
Aus API-Wiki
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. | ||
| − | < | + | <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 | ||
| − | </ | + | </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: | ||
| − | :< | + | :<vb> Const JOYSTICKID1 = 0 |
| − | |||
Const JOYSTICKID2 = 1</code> | Const JOYSTICKID2 = 1</code> | ||
:Auf neueren Systemen sind Werte zwischen | :Auf neueren Systemen sind Werte zwischen | ||
| − | < | + | <vb> Const JOYSTICKID1 = 0</vb> |
:und | :und | ||
| − | < | + | <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: | ||
| − | < | + | <vb> 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) | ||
| − | </ | + | </vb> |
| Zeile 54: | Zeile 52: | ||
===Beispiel=== | ===Beispiel=== | ||
| − | < | + | <vb> |
Dim JC As JOYCAPS | Dim JC As JOYCAPS | ||
| Zeile 62: | Zeile 60: | ||
' Fehler beim Aufruf | ' Fehler beim Aufruf | ||
End If | End If | ||
| − | </ | + | </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
