funzione mixerGetDevCapsA (mmeapi.h)

Articolo
11/20/2024

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

Sintassi

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA 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 in caso di esito positivo o di errore. I possibili valori di errore includono quanto segue.

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

Osservazioni

Usare il mixerGetNumDevs funzione 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 restituisce correttamente.

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

Nota

L'intestazione mmeapi.h definisce mixerGetDevCaps come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	mmeapi.h (include Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Vedere anche

funzioni mixer audio

mixer audio

Condividi tramite