funzione mixerGetLineInfoA (mmeapi.h)
La funzione mixerGetLineInfo recupera informazioni su una linea specifica di un dispositivo mixer.
Sintassi
MMRESULT mixerGetLineInfoA(
HMIXEROBJ hmxobj,
LPMIXERLINEA pmxl,
DWORD fdwInfo
);
Parametri
hmxobj
Gestire l'oggetto del 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 per essere la dimensione, in byte, della struttura MIXERLINE .
fdwInfo
Flag per il recupero di informazioni su una riga audio. I valori seguenti sono definiti.
| 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 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 dal membro dwDestination della struttura MIXERLINE . Questo indice varia da zero a uno minore del valore nel membro cDestinations 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 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 inizializzazione. |
| MIXER_GETLINEINFOF_TARGETTYPE | Il parametro pmxl riceverà informazioni sulla linea audio che è per il 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 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 in e da Unicode, che potrebbe causare la perdita di dati.
|
| MIXER_OBJECTF_AUX | Il parametro hmxobj è un identificatore di dispositivo ausiliario nell'intervallo di zero a uno inferiore al 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 waveform-audio restituito dalla funzione waveInOpen . |
| MIXER_OBJECTF_HWAVEOUT | Il parametro hmxobj è un handle di output waveform-audio restituito dalla funzione waveOutOpen . |
| MIXER_OBJECTF_MIDIIN | Il parametro hmxobj è l'identificatore di un dispositivo di input MIDI. Questo identificatore deve trovarsi nell'intervallo di zero a uno inferiore al 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 di zero a uno inferiore al numero di dispositivi restituiti dalla funzione midiOutGetNumDevs . |
| MIXER_OBJECTF_MIXER | Il parametro hmxobj è un identificatore di dispositivo mixer nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione mixerGetNumDevs . Questo flag è facoltativo. |
| MIXER_OBJECTF_WAVEIN | Il parametro hmxobj è l'identificatore di un dispositivo di input waveform-audio nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione waveInGetNumDevs . |
| MIXER_OBJECTF_WAVEOUT | Il parametro hmxobj è l'identificatore di un dispositivo di output waveform-audio nell'intervallo di zero a uno inferiore al numero di dispositivi restituiti dalla funzione waveOutGetNumDevs . |
Valore restituito
Restituisce MMSYSERR_NOERROR se ha 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. |
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| 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 (includere Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |