Dimensioni, in byte, della struttura MIXERLINE. Questo membro deve essere inizializzato prima di chiamare la funzione mixerGetLineInfo. Le dimensioni specificate in questo membro devono essere sufficienti per contenere la struttura MIXERLINE. Quando mixerGetLineInfo restituisce, questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non supereranno le dimensioni richieste.
dwDestination
Indice della riga di destinazione. Questo membro varia da zero a uno minore del valore specificato nella cDestinations membro della struttura MIXERCAPS recuperata dalla funzione mixerGetDevCaps . Quando la funzione mixerGetLineInfo viene chiamata con il flag MIXER_GETLINEINFOF_DESTINATION, vengono restituite le proprietà per la riga di destinazione. Il membro dwSource deve essere impostato su zero in questo caso. Quando viene chiamato con il flag di MIXER_GETLINEINFOF_SOURCE, vengono restituite le proprietà per l'origine specificata dal membro dwSource associato al membro dwDestination.
dwSource
Indice per la riga di origine audio associata al membro dwDestination. Ovvero, questo membro specifica il nriga di origine audio associata alla riga di destinazione audio specificata. Questo membro non viene utilizzato per le righe di destinazione e deve essere impostato su zero quando MIXER_GETLINEINFOF_DESTINATION viene specificato nella funzione mixerGetLineInfo. Quando viene specificato il flag MIXER_GETLINEINFOF_SOURCE, questo membro varia da zero a uno minore del valore specificato nel membro cConnections per la riga di destinazione audio specificata nel membro dwDestination.
dwLineID
Identificatore definito dal dispositivo mixer che fa riferimento in modo univoco alla linea audio descritta dalla struttura MIXERLINE. Questo identificatore è univoco per ogni dispositivo mixer e può essere in qualsiasi formato. Un'applicazione deve usare questo identificatore solo come handle astratto.
fdwLine
Stato e flag di supporto per la linea audio. Questo membro viene sempre restituito all'applicazione e non richiede alcuna inizializzazione.
Nome
Descrizione
MIXERLINE_LINEF_ACTIVE
La linea audio è attiva. Una linea attiva indica che è probabile che un segnale passi attraverso la linea.
MIXERLINE_LINEF_DISCONNECTED
La linea audio è disconnessa. I controlli associati di una riga disconnessa possono comunque essere modificati, ma le modifiche non hanno alcun effetto fino a quando la riga non è connessa.
MIXERLINE_LINEF_SOURCE
La linea audio è una linea di origine audio associata a una singola linea di destinazione audio. Se questo flag non è impostato, questa riga è una riga di destinazione audio associata a zero o più righe di origine audio.
Se un'applicazione non usa un dispositivo di output audio waveform, la linea audio associata a tale dispositivo non sarà attiva , ovvero il flag MIXERLINE_LINEF_ACTIVE non verrà impostato.
Se il dispositivo di output audio waveform viene aperto, la riga audio viene considerata attiva e verrà impostato il flag MIXERLINE_LINEF_ACTIVE.
Un dispositivo di output audio waveform sospeso o a stella è ancora considerato attivo. In altre parole, se il dispositivo di output audio waveform viene aperto da un'applicazione indipendentemente dal fatto che i dati vengano riprodotti, la linea audio associata viene considerata attiva.
Se una linea non può essere definita rigorosamente come attiva, il dispositivo mixer imposta sempre il flag di MIXERLINE_LINEF_ACTIVE.
dwUser
Dati dell'istanza definiti dal dispositivo audio per la riga. Questo membro è destinato alle applicazioni mixer personalizzate progettate appositamente per il dispositivo mixer che restituisce queste informazioni. Altre applicazioni devono ignorare questi dati.
dwComponentType
Tipo di componente per questa linea audio. Un'applicazione può usare queste informazioni per visualizzare grafica personalizzata o per cercare un determinato componente. Se un'applicazione non usa tipi di componenti, questo membro deve essere ignorato. Questo membro può essere uno dei valori seguenti:
Nome
Descrizione
MIXERLINE_COMPONENTTYPE_DST_DIGITAL
La linea audio è una destinazione digitale( ad esempio, l'input digitale in un dispositivo audio DAT o CD).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES
La linea audio è una destinazione regolabile (guadagno e/o attenuazione) destinata a guidare le cuffie. La maggior parte delle schede audio utilizza la stessa linea di destinazione audio per altoparlanti e cuffie, nel qual caso il dispositivo mixer usa semplicemente il tipo di MIXERLINE_COMPONENTTYPE_DST_SPEAKERS.
MIXERLINE_COMPONENTTYPE_DST_LINE
La linea audio è una destinazione a livello di riga (ad esempio, input a livello di riga da un dispositivo audio CD) che sarà l'origine di registrazione finale per il convertitore analogico-digitale (ADC). Poiché la maggior parte delle schede audio per i personal computer fornisce una sorta di guadagno per la linea di origine audio di registrazione, il dispositivo mixer userà il tipo di MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_MONITOR
La linea audio è una destinazione usata per un monitor.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS
La linea audio è una destinazione regolabile (guadagno e/o attenuazione) destinata agli altoparlanti. Si tratta del tipo di componente tipico per l'output audio delle schede audio per i personal computer.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE
La linea audio è una destinazione che verrà instradata a una linea telefonica.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED
La linea audio è una destinazione che non può essere definita da uno dei tipi di componenti standard. Un dispositivo mixer è necessario per usare questo tipo di componente per i tipi di componenti linea che non sono stati definiti da Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN
La linea audio è una destinazione che sarà l'origine di registrazione finale per l'input vocale. Questo tipo di componente è esattamente come MIXERLINE_COMPONENTTYPE_DST_WAVEIN, ma è destinato specificamente alle impostazioni usate durante la registrazione/riconoscimento vocale. Il supporto per questa linea è facoltativo per un dispositivo mixer. Molti dispositivi mixer forniscono solo MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN
La linea audio è una destinazione che sarà l'origine di registrazione finale per l'input audio waveform(ADC). Questa linea fornisce in genere una sorta di guadagno o attenuazione. Si tratta del tipo di componente tipico per la linea di registrazione della maggior parte delle schede audio per i personal computer.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG
La linea audio è un'origine analogica (ad esempio, output analogico da un nastro video-cassetta).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY
La linea audio è un'origine proveniente dalla linea audio ausiliaria. Questo tipo di riga è destinato a un'origine con guadagno o attenuazione che può essere instradata alla destinazione MIXERLINE_COMPONENTTYPE_DST_SPEAKERS e/o registrata dalla destinazione MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC
La linea audio è un'origine proveniente dall'output di un CD audio interno. Questo tipo di componente viene fornito per le schede audio che forniscono una linea di origine audio che deve essere connessa a un CD audio (o CD-ROM la riproduzione di un CD audio).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL
La linea audio è un'origine digitale (ad esempio, l'output digitale da un DAT o un CD audio).
MIXERLINE_COMPONENTTYPE_SRC_LINE
La linea audio è un'origine a livello di riga (ad esempio, input a livello di riga da uno stereo esterno) che può essere usata come origine di registrazione facoltativa. Poiché la maggior parte delle schede audio per i personal computer fornisce una sorta di guadagno per la linea di origine della registrazione, il dispositivo mixer userà il tipo di MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE
La linea audio è un'origine di registrazione del microfono. La maggior parte delle schede audio per i personal computer fornisce almeno due tipi di origini di registrazione: una linea audio ausiliaria e l'input del microfono. Una linea audio del microfono offre in genere una sorta di guadagno. Le schede audio che usano un singolo input per l'uso con un microfono o una linea audio ausiliaria devono usare il tipo di componente MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER
La linea audio è un'origine proveniente dall'altoparlante del personal computer. Diverse schede audio per i personal computer offrono la possibilità di combinare ciò che in genere verrebbe riprodotto sull'altoparlante interno con l'output di una scheda audio. Alcune schede audio supportano la possibilità di usare questo output come origine di registrazione.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER
La linea audio è un'origine proveniente dall'output di un sintetizzatore interno. La maggior parte delle schede audio per i personal computer fornisce una sorta di sintetizzatore MIDI.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE
La linea audio è un'origine proveniente da una linea telefonica in ingresso.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED
La linea audio è un'origine che non può essere definita da uno dei tipi di componenti standard. Un dispositivo mixer è necessario per usare questo tipo di componente per i tipi di componenti linea che non sono stati definiti da Microsoft Corporation.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT
La linea audio è un'origine proveniente dal convertitore da applicazione livello dati (DAC) dell'output audio waveform-to-analogico. La maggior parte delle schede audio per i personal computer fornisce questo tipo di componente come origine alla destinazione MIXERLINE_COMPONENTTYPE_DST_SPEAKERS. Alcune schede consentono anche di instradare questa origine alla destinazione MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
cChannels
Numero massimo di canali separati che possono essere modificati in modo indipendente per la linea audio. Il valore minimo per questo campo è 1 perché una riga deve avere almeno un canale.
La maggior parte delle schede audio moderne per i personal computer sono dispositivi stereo; per loro, il valore di questo membro è 2.
Canale 1 si presuppone che sia il canale sinistro; canale 2 si presuppone che sia il canale corretto.
A una linea multicanale potrebbe essere associato uno o più controlli uniformi (controlli che influiscono su tutti i canali di una linea in modo uniforme).
cConnections
Numero di connessioni associate alla linea audio. Questo membro viene utilizzato solo per le righe di destinazione audio e specifica il numero di righe di origine audio associate. Questo membro è sempre zero per le righe di origine e per le righe di destinazione che non dispongono di linee di origine audio associate.
cControls
Numero di controlli associati alla linea audio. Questo valore può essere zero. Se alla riga non sono associati controlli, è probabile che la riga sia un'origine che potrebbe essere selezionata in un MIXERCONTROL_CONTROLTYPE_MUX o MIXERCONTROL_CONTROLTYPE_MIXER, ma non consente alcuna manipolazione del segnale.
szShortName[MIXER_SHORT_NAME_CHARS]
Stringa breve che descrive la linea del mixer audio specificata nel membro dwLineID . Questa descrizione deve essere appropriata come etichetta concisa per la riga.
szName[MIXER_LONG_NAME_CHARS]
Stringa che descrive la linea del mixer audio specificata nel membro dwLineID . Questa descrizione deve essere appropriata come descrizione completa per la riga.
Target
Informazioni sui supporti di destinazione.
Target.dwType
Tipo di dispositivo multimediale di destinazione associato alla riga audio descritta nella struttura MIXERLINE. Un'applicazione deve ignorare le informazioni di destinazione per i tipi di dispositivi multimediali che non usa. Sono definiti i valori seguenti:
Nome
Descrizione
MIXERLINE_TARGETTYPE_AUX
La linea audio descritta dalla struttura MIXERLINE è strettamente associata al dispositivo ausiliario nei membri rimanenti della struttura target della struttura MIXERLINE.
MIXERLINE_TARGETTYPE_MIDIIN
La linea audio descritta dalla struttura MIXERLINE è strettamente associata al dispositivo di input MIDI nei membri rimanenti della struttura target della struttura MIXERLINE.
MIXERLINE_TARGETTYPE_MIDIOUT
La linea audio descritta dalla struttura MIXERLINE è strettamente associata al dispositivo di output MIDI nei membri rimanenti della struttura target della struttura MIXERLINE.
MIXERLINE_TARGETTYPE_UNDEFINED
La linea audio descritta dalla struttura MIXERLINE non è strettamente associata a un tipo di supporto definito. Tutti i membri della struttura Target rimanenti della struttura MIXERLINE devono essere ignorati. Un'applicazione non può usare il tipo di destinazione MIXERLINE_TARGETTYPE_UNDEFINED quando si chiama la funzione mixerGetLineInfo con il flag di MIXER_GETLINEINFOF_TARGETTYPE.
MIXERLINE_TARGETTYPE_WAVEIN
La linea audio descritta dalla struttura MIXERLINE è strettamente associata al dispositivo di input audio waveform dettagliato nei membri rimanenti della struttura Target della struttura MIXERLINE.
MIXERLINE_TARGETTYPE_WAVEOUT
La linea audio descritta dalla struttura MIXERLINE è strettamente associata al dispositivo di output audio waveform descritto nei membri rimanenti della struttura Target della struttura MIXERLINE.
Target.dwDeviceID
L'identificatore di dispositivo corrente del dispositivo multimediale di destinazione quando il membro dwType è un tipo di destinazione diverso da MIXERLINE_TARGETTYPE_UNDEFINED. Questo identificatore è identico all'indice del dispositivo multimediale corrente del dispositivo multimediale associato. Quando si chiama la funzione mixerGetLineInfo con il flag MIXER_GETLINEINFOF_TARGETTYPE, questo membro viene ignorato all'input e verrà restituito al chiamante dal gestore mixer audio.
Target.wMid
Identificatore produttore del dispositivo multimediale di destinazione quando il membro dwType è un tipo di destinazione diverso da MIXERLINE_TARGETTYPE_UNDEFINED. Questo identificatore è identico al wMid membro della struttura device-capabilities per il supporto associato. Gli identificatori del produttore sono definiti in Manufacturer e Product Identifiers.
Target.wPid
Identificatore del prodotto del dispositivo multimediale di destinazione quando il membro dwType è un tipo di destinazione diverso da MIXERLINE_TARGETTYPE_UNDEFINED. Questo identificatore è identico al wPid membro della struttura delle funzionalità del dispositivo per il supporto associato. Gli identificatori di prodotto sono definiti in Manufacturer e Product Identifiers.
Target.vDriverVersion
Versione del driver del dispositivo multimediale di destinazione quando il membro dwType è un tipo di destinazione diverso da MIXERLINE_TARGETTYPE_UNDEFINED. Questa versione è identica alla vDriverVersion membro della struttura delle funzionalità del dispositivo per il supporto associato.
Target.szPname[MAXPNAMELEN]
Nome del prodotto del dispositivo multimediale di destinazione quando il membro dwType è un tipo di destinazione diverso da MIXERLINE_TARGETTYPE_UNDEFINED. Questo nome è identico al szPname membro della struttura device-capabilities per il supporto associato.
Osservazioni
Nota
L'intestazione mmeapi.h definisce MIXERLINE 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.