funzione mixerGetLineInfo (mmeapi.h)
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 |
|---|---|
|
Il riferimento alla riga audio non è valido. |
|
Il parametro hmxobj specifica un identificatore di dispositivo non valido. |
|
Uno o più flag non sono validi. |
|
Il parametro hmxobj specifica un handle non valido. |
|
Uno o più parametri non sono validi. |
|
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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per