Share via

funzione mixerGetDevCaps (mmeapi.h)

  • Articolo

La funzione mixerGetDevCaps esegue una query su un dispositivo mixer specificato per determinare le relative funzionalità.

Sintassi

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS pmxcaps,
  UINT        cbmxcaps
);

Parametri

uMxId

Identificatore o handle di un dispositivo mixer aperto.

pmxcaps

Puntatore a una struttura MIXERCAPS che riceve informazioni sulle funzionalità del dispositivo.

cbmxcaps

Dimensioni, in byte, della struttura MIXERCAPS .

Valore restituito

Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
MMSYSERR_BADDEVICEID
 L'identificatore del dispositivo specificato non è compreso nell'intervallo.
MMSYSERR_INVALHANDLE
 L'handle del dispositivo mixer non è valido.
MMSYSERR_INVALPARAM
 Uno o più parametri non sono validi.

Commenti

Usare la funzione mixerGetNumDevs per determinare il numero di dispositivi mixer presenti nel sistema. L'identificatore del dispositivo specificato da uMxId varia da zero a uno minore del numero di dispositivi mixer presenti.

Solo il numero di byte (o minore) di informazioni specificate in cbmxcaps viene copiato nella posizione a cui punta pmxcaps. Se cbmxcaps è zero, non viene copiato alcun elemento e la funzione viene restituita correttamente.

Questa funzione accetta anche un handle del dispositivo mixer restituito dalla funzione mixerOpen come parametro uMxId . L'applicazione deve eseguire il cast dell'handle HMIXER a un UINT.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mmeapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Funzioni mixer audio

Mixer audio