funzione joySetCapture (joystickapi.h)
La funzione joySetCapture acquisisce un joystick causando l'invio dei messaggi alla finestra specificata.
Sintassi
MMRESULT joySetCapture(
HWND hwnd,
UINT uJoyID,
UINT uPeriod,
BOOL fChanged
);
Parametri
hwnd
Gestire la finestra per ricevere i messaggi del joystick.
uJoyID
Identificatore del joystick da acquisire. Valori validi per l'intervallo uJoyID compreso tra zero (JOYSTICKID1) e 15.
uPeriod
Frequenza di polling, in millisecondi.
fChanged
Modificare il flag di posizione. Specificare TRUE per questo parametro per inviare messaggi solo quando la posizione cambia in base a un valore maggiore della soglia di spostamento del joystick. In caso contrario, i messaggi vengono inviati alla frequenza di polling specificata in uPeriod.
Valore restituito
Restituisce JOYERR_NOERROR se ha esito positivo o uno dei valori di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il driver del joystick non è presente. |
|
L'ID del joystick o hwnd non valido è NULL. |
|
Impossibile acquisire l'input del joystick perché un servizio obbligatorio (ad esempio un timer di Windows) non è disponibile. |
|
Il joystick specificato non è connesso al sistema. |
|
L'ID del joystick o hwnd non valido è NULL. |
Commenti
Se il joystick specificato è attualmente acquisito, la funzione restituisce un comportamento non definito. Chiamare la funzione joyReleaseCapture per rilasciare il joystick acquisito o distruggere la finestra per rilasciare automaticamente il joystick.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | joystickapi.h (include Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |