funzione joySetCapture (joystickapi.h)

Articolo
08/24/2023

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
MMSYSERR_NODRIVER	Il driver del joystick non è presente.
MMSYSERR_INVALPARAM	L'ID del joystick o hwnd non valido è NULL.
JOYERR_NOCANDO	Impossibile acquisire l'input del joystick perché un servizio obbligatorio (ad esempio un timer di Windows) non è disponibile.
JOYERR_UNPLUGGED	Il joystick specificato non è connesso al sistema.
JOYERR_PARMS	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

Vedi anche

Joystick

Funzioni del joystick multimediale

Share via