funzione mixerGetLineInfoW (mmeapi.h)

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

Sintassi

MMRESULT mixerGetLineInfoW(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEW 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 è piena di 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 riga audio. Vengono definiti i valori seguenti.

Valore	Significato
MIXER_GETLINEINFOF_COMPONENTTYPE	Il parametro pmxl riceverà informazioni sulla prima riga audio del tipo specificato nel dwComponentType membro della struttura MIXERLINE. Questo flag viene usato per recuperare informazioni su una riga audio di un tipo di componente specifico. I membri della struttura rimanenti, ad eccezione di cbStruct non richiedono ulteriori inizializzazione.
MIXER_GETLINEINFOF_DESTINATION	Il parametro pmxl riceverà informazioni sulla linea audio di destinazione specificata dalla dwDestination membro della struttura MIXERLINE. Questo indice è compreso tra zero e uno minore del valore nella cDestinations membro della struttura MIXERCAPS. Tutti i membri della struttura rimanenti ad eccezione di cbStruct non richiedono ulteriori inizializzazione.
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 inizializzazione.
MIXER_GETLINEINFOF_SOURCE	Il parametro pmxl riceve informazioni sulla linea audio di origine specificata dalla dwDestination e dwSource membri della struttura MIXERLINE . L'indice specificato da dwDestination varia da zero a uno minore del valore nella cDestinations membro della struttura MIXERCAPS. L'indice specificato da dwSource è compreso tra zero e uno minore del valore nel membro cConnections della struttura MIXERLINE restituita per la riga audio archiviata nel membro dwDestination. Tutti i membri della struttura rimanenti ad eccezione di cbStruct non richiedono ulteriori inizializzazione.
MIXER_GETLINEINFOF_TARGETTYPE	Il parametro pmxl riceverà informazioni sulla linea audio relativa al membro dwType della struttura Target, membro della struttura MIXERLINE . Questo flag viene usato per recuperare informazioni su una riga audio che gestisce il tipo di destinazione (ad esempio, MIXERLINE_TARGETTYPE_WAVEOUT). L'applicazione deve inizializzare ildwType , wMid, wPid, vDriverVersion e membri 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 inizializzazione. 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 da e verso Unicode, che potrebbe comportare la perdita di dati.
MIXER_OBJECTF_AUX	Il parametro hmxobj è un identificatore del dispositivo ausiliario compreso nell'intervallo da zero a uno minore del numero di dispositivi restituiti dal funzione auxGetNumDevs.
MIXER_OBJECTF_HMIDIIN	Il parametro hmxobj è l'handle di un dispositivo di input MIDI. Questa maniglia deve essere stata restituita 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 in caso di esito positivo o di errore. I possibili valori di errore 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.

Osservazioni

Nota

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