Struttura MIXERLINEA (mmeapi.h)

  • Articolo

La struttura MIXERLINE descrive lo stato e le metriche di una linea audio.

Sintassi

typedef struct tagMIXERLINEA {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  CHAR      szShortName[MIXER_SHORT_NAME_CHARS];
  CHAR      szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    CHAR      szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEA, *PMIXERLINEA, *LPMIXERLINEA;

Members

cbStruct

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 superano le dimensioni richieste.

dwDestination

Indice della riga di destinazione. Questo membro varia da zero a uno minore del valore specificato nel membro cDestinations della struttura MIXERCAPS recuperato dalla funzione mixerGetDevCaps . Quando viene chiamata la funzione mixerGetLineInfo 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 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 . Questo membro specifica la riga di origine audio nn associata alla riga di destinazione audio specificata. Questo membro non viene usato per le righe di destinazione e deve essere impostato su zero quando viene specificato MIXER_GETLINEINFOF_DESTINATION 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 l'inizializzazione.

Nome Descrizione
MIXERLINE_LINEF_ACTIVE
 La linea audio è attiva. Una linea attiva indica che probabilmente un segnale passa attraverso la linea.
MIXERLINE_LINEF_DISCONNECTED
 La linea audio è disconnessa. È comunque possibile modificare i controlli associati di una riga disconnessa, ma le modifiche non hanno alcun effetto finché 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 waveform-audio, la linea audio associata a tale dispositivo non sarebbe attiva, ovvero il flag di MIXERLINE_LINEF_ACTIVE non verrà impostato.

Se il dispositivo di output waveform-audio viene aperto, la riga audio viene considerata attiva e verrà impostato il flag MIXERLINE_LINEF_ACTIVE.

Un dispositivo di output waveform-audio sospeso o predefinito è ancora considerato attivo. In altre parole, se il dispositivo di output waveform-audio viene aperto da un'applicazione indipendentemente dal fatto che i dati vengano riprodotti, la riga audio associata viene considerata attiva.

Se non è possibile definire rigorosamente una linea 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 in modo specifico 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 componente, 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 usa 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 linea ,ad esempio l'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 computer personali offre un certo tipo 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 utilizzata per un monitoraggio.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS
 La linea audio è una destinazione regolabile (guadagno e/o attenuazione) destinata all'unità degli altoparlanti. Si tratta del tipo di componente tipico per l'output audio delle schede audio per i computer personali.
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. È necessario usare questo tipo di componente per i tipi di componente 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 in modo specifico alle impostazioni usate durante la registrazione vocale/riconoscimento. 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 in genere fornisce una sorta di guadagno o attenuazione. Si tratta del tipo di componente tipico per la riga di registrazione della maggior parte delle schede audio per i computer personali.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG
 La linea audio è un'origine analogica(ad esempio, output analogico da un nastro video-cassette).
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 instradato 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 schede audio che forniscono una linea di origine audio destinata a essere connessa a un CD audio (o CD-ROM che riproduce un CD audio).
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL
 La linea audio è un'origine digitale, ad esempio l'output digitale da un CD audio o DAT.
MIXERLINE_COMPONENTTYPE_SRC_LINE
 La linea audio è un'origine a livello di linea,ad esempio l'input a livello di riga da uno stereo esterno, che può essere usato come origine di registrazione facoltativa. Poiché la maggior parte delle schede audio per i computer personali offre un certo tipo 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 computer personali 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 un certo tipo di guadagno. Le schede audio che usano un singolo input da usare 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 computer personale. 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. È necessario un dispositivo mixer 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 (Waveform-Audio Output digital-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; si presuppone che channel 2 sia il canale corretto.

A una riga multicanale potrebbe essere associato uno o più controlli uniformi (controlli che interessano tutti i canali di una riga 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 a cui non sono associate righe di origine audio.

cControls

Numero di controlli associati alla linea audio. Il 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. Vengono definiti i valori seguenti:

Nome Descrizione
MIXERLINE_TARGETTYPE_AUX
 La linea audio descritta dalla struttura MIXERLINE è strettamente associata al dispositivo ausiliario descritto 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 descritto 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 dettagliato 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 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 dettagliato nei membri rimanenti della struttura Target della struttura MIXERLINE .

Target.dwDeviceID

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 nell'input e verrà restituito al chiamante dal gestore mixer audio.

Target.wMid

Identificatore del produttore del dispositivo multimediale di destinazione quando il membro dwType è un tipo di destinazione diverso da MIXERLINE_TARGETTYPE_UNDEFINED. Questo identificatore è identico al membro wMid 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 membro wPid della struttura device-capabilities 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 al membro vDriverVersion della struttura device-capabilities 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 membro szPname della struttura device-capabilities per il supporto associato.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione mmeapi.h

Vedi anche

Strutture mixer audio

Mixer audio

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo