Struttura MIXERLINECONTROLS (mmeapi.h)
La struttura MIXERLINECONTROLS contiene informazioni sui controlli di una linea audio.
Sintassi
typedef struct tMIXERLINECONTROLS {
DWORD cbStruct;
DWORD dwLineID;
union {
DWORD dwControlID;
DWORD dwControlType;
};
DWORD cControls;
DWORD cbmxctrl;
LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;
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 viene restituito mixerGetLineControls , questo membro contiene le dimensioni effettive delle informazioni restituite. Le informazioni restituite non supereranno le dimensioni richieste, né saranno inferiori alla struttura MIXERLINECONTROLS .
dwLineID
Identificatore della riga per i quali vengono sottoposti a query i controlli. Questo membro non viene usato se il flag 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 utilizzati quando viene specificato MIXER_GETLINECONTROLSF_ALL.
dwControlID
Identificatore di controllo del controllo desiderato. Questo membro viene utilizzato con il flag MIXER_GETLINECONTROLSF_ONEBYID per la funzione mixerGetLineControls per recuperare le informazioni sul 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.
dwControlType
Classe dei tipi di controllo desiderati. Questo membro viene utilizzato 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 viene specificato MIXER_GETLINECONTROLSF_ONEBYID o MIXER_GETLINECONTROLSF_ONEBYTYPE o il valore restituito nel membro cControls della struttura MIXERLINE restituito per una linea audio. Questo membro non può essere zero. Se una linea audio specifica che non ha controlli, mixerGetLineControls non deve essere chiamato.
cbmxctrl
Dimensioni, in byte, di una singola struttura MIXERCONTROL . Le dimensioni specificate in questo membro devono essere sufficienti per contenere la struttura MIXERCONTROL di base. La dimensione totale, in byte, necessaria 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 sufficientemente grande da 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 corretta.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | mmeapi.h |