Struttura MIXERLINECONTROLSW (mmeapi.h)

Articolo
11/20/2024

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;

Membri

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 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 utilizzato 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 si specifica MIXER_GETLINECONTROLSF_ALL.

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

Identificatore di controllo del controllo desiderato. Questo membro viene utilizzato con il flag di MIXER_GETLINECONTROLSF_ONEBYID per la funzione mixerGetLineControls per recuperare le informazioni sul 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 utilizzato insieme al tipo di query MIXER_GETLINECONTROLSF_ONEBYTYPE.

DUMMYUNIONNAME.dwControlType

Classe dei tipi di controllo desiderati. Questo membro viene utilizzato con il flag di MIXER_GETLINECONTROLSF_ONEBYTYPE per la funzione mixerGetLineControls per recuperare il primo controllo della classe specificata sulla riga specificata dal membro dwLineID della struttura MIXERLINECONTROLS. Questo membro si sovrappone al membro dwControlID e non può essere utilizzato insieme al tipo di query MIXER_GETLINECONTROLSF_ONEBYID. Vedere la descrizione del membro dwControlType in MIXERCONTROL.

cControls

Numero di elementi 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 viene specificato o il valore restituito nel membro cControls della struttura MIXERLINE restituita per una linea audio. Questo membro non può essere zero. Se una linea audio specifica che non dispone di controlli, mixerGetLineControls non deve essere chiamato.

cbmxctrl

Dimensioni, in byte, di una singola struttura MIXERCONTROL. Le dimensioni specificate in questo membro devono essere almeno sufficienti per contenere la struttura di base MIXERCONTROL. Le dimensioni totali, in byte, necessarie per il buffer a cui punta il membro pamxctrl è il prodotto del cbmxctrl e cControls membri 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 sufficientemente grande da contenere una struttura di base MIXERCONTROL. 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.

Osservazioni

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 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	mmeapi.h

Vedere anche

strutture mixer audio

Condividi tramite