Funzione auxGetDevCapsA (mmeapi.h)

Articolo
11/20/2024

La funzione auxGetDevCaps recupera le funzionalità di un determinato dispositivo di output ausiliario.

Sintassi

MMRESULT auxGetDevCapsA(
  UINT_PTR   uDeviceID,
  LPAUXCAPSA pac,
  UINT       cbac
);

Parametri

uDeviceID

Identificatore del dispositivo di output ausiliario su cui eseguire una query. Specificare un identificatore di dispositivo valido (vedere la sezione dei commenti seguenti) oppure usare la costante seguente:

Valore	Significato
AUX_MAPPER	Mapper audio ausiliario. La funzione restituisce un errore se non è installato alcun mapper audio ausiliario.

pac

Puntatore a una struttura AUXCAPS da compilare con informazioni sulle funzionalità del dispositivo.

cbac

Dimensioni, in byte, della struttura AUXCAPS .

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.

Osservazioni

L'identificatore del dispositivo in uDeviceID varia da zero a uno minore del numero di dispositivi presenti. AUX_MAPPER possono essere utilizzati anche. Usare la funzione auxGetNumDevs per determinare il numero di dispositivi di output ausiliari presenti nel sistema.

Nota

L'intestazione mmeapi.h definisce auxGetDevCaps 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

audio waveform

funzioni waveform

Condividi tramite