funzione mixerGetLineInfo (mmeapi.h)

Articolo
02/29/2024

La funzione mixerGetLineInfo recupera informazioni su una linea specifica di un dispositivo mixer.

Sintassi

MMRESULT mixerGetLineInfo(
  HMIXEROBJ   hmxobj,
  LPMIXERLINE pmxl,
  DWORD       fdwInfo
);

Parametri

hmxobj

Handle per l'oggetto dispositivo mixer che controlla la linea audio specifica.

pmxl

Puntatore a una struttura MIXERLINE . Questa struttura contiene informazioni sulla linea audio per il dispositivo mixer. Il membro cbStruct deve essere sempre inizializzato in byte della struttura MIXERLINE .

fdwInfo

Flag per il recupero di informazioni su una linea audio. Vengono definiti i valori seguenti.

Valore	Significato
MIXER_GETLINEINFOF_COMPONENTTYPE	Il parametro pmxl riceverà informazioni sulla prima riga audio del tipo specificato nel membro dwComponentType della struttura MIXERLINE . Questo flag viene usato per recuperare informazioni su una linea audio di un tipo di componente specifico. I membri della struttura rimanenti, ad eccezione di cbStruct , non richiedono ulteriori inizializzazioni.
MIXER_GETLINEINFOF_DESTINATION	Il parametro pmxl riceverà informazioni sulla linea audio di destinazione specificata dal membro dwDestination della struttura MIXERLINE . Questo indice è compreso tra zero e uno minore del valore nel membro cDestinations della struttura MIXERCAPS . Tutti i membri della struttura rimanenti, ad eccezione di cbStruct , non richiedono ulteriori inizializzazioni.
MIXER_GETLINEINFOF_LINEID	Il parametro pmxl riceverà informazioni sulla linea audio specificata dal membro dwLineID della struttura MIXERLINE . Questo viene in genere usato per recuperare informazioni aggiornate sullo stato di una linea audio. Tutti i membri della struttura rimanenti, ad eccezione di cbStruct , non richiedono ulteriori inizializzazioni.
MIXER_GETLINEINFOF_SOURCE	Il parametro pmxl riceverà informazioni sulla linea audio di origine specificata dai membri dwDestination e dwSource della struttura MIXERLINE . L'indice specificato da dwDestination varia da zero a uno minore del valore nel membro cDestinations della struttura MIXERCAPS . L'indice specificato da dwSource varia da zero a uno minore del valore nel membro cConnections della struttura MIXERLINE restituito per la riga audio archiviata nel membro dwDestination . Tutti i membri della struttura rimanenti, ad eccezione di cbStruct , non richiedono ulteriori inizializzazioni.
MIXER_GETLINEINFOF_TARGETTYPE	Il parametro pmxl riceverà informazioni sulla linea audio relativa al membro dwType della struttura Target , che è un membro della struttura MIXERLINE . Questo flag viene usato per recuperare informazioni su una linea audio che gestisce il tipo di destinazione (ad esempio, MIXERLINE_TARGETTYPE_WAVEOUT). L'applicazione deve inizializzare i membri dwType, wMid, wPid, vDriverVersion e szPname della struttura MIXERLINE prima di chiamare mixerGetLineInfo. Tutti questi valori possono essere recuperati dalle strutture delle funzionalità del dispositivo per tutti i dispositivi multimediali. I membri della struttura rimanenti, ad eccezione di cbStruct , non richiedono ulteriori inizializzazioni. Nota Nella versione ANSI di questa funzione (mixerGetLineInfoA), non è possibile usare la stringa ANSI restituita da mixerGetLineInfo o waveOutGetDevCaps per il valore della stringa psPname quando si chiama mixerGetLineInfo con il flag MIXER_GETLINEINFOF_TARGETTYPE . Il motivo è che viene eseguita una conversione interna in e da Unicode, che potrebbe comportare la perdita di dati.
MIXER_OBJECTF_AUX	Il parametro hmxobj è un identificatore di dispositivo ausiliario compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN	Il parametro hmxobj è l'handle di un dispositivo di input MIDI. Questo handle deve essere stato restituito dalla funzione midiInOpen .
MIXER_OBJECTF_HMIDIOUT	Il parametro hmxobj è l'handle di un dispositivo di output MIDI. Questo handle deve essere stato restituito dalla funzione midiOutOpen .
MIXER_OBJECTF_HMIXER	Il parametro hmxobj è un handle del dispositivo mixer restituito dalla funzione mixerOpen . Questo flag è facoltativo.
MIXER_OBJECTF_HWAVEIN	Il parametro hmxobj è un handle di input audio waveform restituito dalla funzione waveInOpen .
MIXER_OBJECTF_HWAVEOUT	Il parametro hmxobj è un handle di output audio waveform restituito dalla funzione waveOutOpen .
MIXER_OBJECTF_MIDIIN	Il parametro hmxobj è l'identificatore di un dispositivo di input MIDI. Questo identificatore deve essere compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT	Il parametro hmxobj è l'identificatore di un dispositivo di output MIDI. Questo identificatore deve essere compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione midiOutGetNumDevs .
MIXER_OBJECTF_MIXER	Il parametro hmxobj è un identificatore del dispositivo mixer compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione mixerGetNumDevs . Questo flag è facoltativo.
MIXER_OBJECTF_WAVEIN	Il parametro hmxobj è l'identificatore di un dispositivo di input audio waveform nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	Il parametro hmxobj è l'identificatore di un dispositivo di output audio waveform nell'intervallo da zero a uno minore del numero di dispositivi restituiti dalla funzione waveOutGetNumDevs .

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
MIXERR_INVALLINE	Il riferimento alla riga audio non è valido.
MMSYSERR_BADDEVICEID	Il parametro hmxobj specifica un identificatore di dispositivo non valido.
MMSYSERR_INVALFLAG	Uno o più flag non sono validi.
MMSYSERR_INVALHANDLE	Il parametro hmxobj specifica un handle non valido.
MMSYSERR_INVALPARAM	Uno o più parametri non sono validi.
MMSYSERR_NODRIVER	Nessun dispositivo mixer è disponibile per l'oggetto specificato da hmxobj.

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

Condividi tramite