Struttura MIXERLINECONTROLSW (mmeapi.h)
La struttura MIXERLINECONTROLS contiene informazioni sui controlli di una linea audio.
Sintassi
typedef struct tagMIXERLINECONTROLSW {
DWORD cbStruct;
DWORD dwLineID;
union {
DWORD dwControlID;
DWORD dwControlType;
} DUMMYUNIONNAME;
DWORD cControls;
DWORD cbmxctrl;
LPMIXERCONTROLW pamxctrl;
} MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW;
Members
cbStruct
Dimensioni, in byte, della struttura MIXERLINECONTROLS . Questo membro deve essere inizializzato prima di chiamare la funzione mixerGetLineControls . Le dimensioni specificate in questo membro devono essere sufficienti per contenere la struttura MIXERLINECONTROLS . Quando mixerGetLineControls restituisce , questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non superano le dimensioni richieste, né saranno inferiori alla struttura MIXERLINECONTROLS .
dwLineID
Identificatore della riga per cui vengono sottoposti query i controlli. Questo membro non viene usato se il flag di MIXER_GETLINECONTROLSF_ONEBYID viene specificato per la funzione mixerGetLineControls , ma il dispositivo mixer restituisce comunque questo membro in questo caso. I membri dwControlID e dwControlType non vengono usati quando viene specificato MIXER_GETLINECONTROLSF_ALL.
DUMMYUNIONNAME
DUMMYUNIONNAME.dwControlID
Identificatore di controllo del controllo desiderato. Questo membro viene usato con il flag MIXER_GETLINECONTROLSF_ONEBYID per la funzione mixerGetLineControls per recuperare le informazioni di controllo del controllo specificato. Si noti che il membro dwLineID della struttura MIXERLINECONTROLS verrà restituito dal dispositivo mixer e non è obbligatorio come parametro di input. Questo membro si sovrappone al membro dwControlType e non può essere usato insieme al tipo di query MIXER_GETLINECONTROLSF_ONEBYTYPE.
DUMMYUNIONNAME.dwControlType
Classe dei tipi di controllo desiderati. Questo membro viene usato con il flag MIXER_GETLINECONTROLSF_ONEBYTYPE per la funzione mixerGetLineControls per recuperare il primo controllo della classe specificata nella riga specificata dal membro dwLineID della struttura MIXERLINECONTROLS . Questo membro si sovrappone al membro dwControlID e non può essere usato insieme al tipo di query MIXER_GETLINECONTROLSF_ONEBYID. Vedere la descrizione del membro dwControlType in MIXERCONTROL.
cControls
Numero di elementi della struttura MIXERCONTROL da recuperare. Questo membro deve essere inizializzato dall'applicazione prima di chiamare la funzione mixerGetLineControls . Questo membro può essere 1 solo se MIXER_GETLINECONTROLSF_ONEBYID o MIXER_GETLINECONTROLSF_ONEBYTYPE è specificato o il valore restituito nel membro cControls della struttura MIXERLINE restituito per una linea audio. Questo membro non può essere zero. Se una riga audio specifica che non ha controlli, non deve essere chiamato mixerGetLineControls .
cbmxctrl
Dimensioni, in byte, di una singola struttura MIXERCONTROL . Le dimensioni specificate in questo membro devono essere almeno sufficienti per contenere la struttura BASE MIXERCONTROL . Le dimensioni totali, in byte, necessarie per il buffer a cui punta il membro pamxctrl è il prodotto dei membri cbmxctrl e cControls della struttura MIXERLINECONTROLS .
pamxctrl
Puntatore a una o più strutture MIXERCONTROL per ricevere le proprietà dei controlli linea audio richiesti. Questo membro non può essere NULL e deve essere inizializzato prima di chiamare la funzione mixerGetLineControls . Ogni elemento della matrice di controlli deve essere almeno di grandi dimensioni sufficiente per contenere una struttura MIXERCONTROL di base. Il membro cbmxctrl deve specificare le dimensioni, in byte, di ogni elemento in questa matrice. Nessuna inizializzazione del buffer a cui punta questo membro è richiesta dall'applicazione. Tutti i membri vengono compilati dal dispositivo mixer (incluso il membro cbStruct di ogni struttura MIXERCONTROL ) al momento della restituzione.
Commenti
Nota
L'intestazione mmeapi.h definisce MIXERLINECONTROLS 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] |
| Intestazione | mmeapi.h |