MIXERLINEA-Struktur (mmeapi.h)

Artikel
08/24/2023

Die MIXERLINE-Struktur beschreibt den Zustand und die Metriken einer Audioleitung.

Syntax

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;

Member

cbStruct

Größe der MIXERLINE-Struktur in Bytes. Dieses Element muss initialisiert werden, bevor die Funktion mixerGetLineInfo aufgerufen wird. Die in diesem Member angegebene Größe muss groß genug sein, um die MIXERLINE-Struktur zu enthalten. Wenn mixerGetLineInfo zurückgibt, enthält dieses Element die tatsächliche Größe der zurückgegebenen Informationen. Die zurückgegebenen Informationen überschreiten die angeforderte Größe nicht.

dwDestination

Zielzeilenindex. Dieser Member reicht von null bis eins kleiner als der Wert, der im cDestinations-Member der MIXERCAPS-Struktur angegeben ist, der von der mixerGetDevCaps-Funktion abgerufen wird. Wenn die mixerGetLineInfo-Funktion mit dem flag MIXER_GETLINEINFOF_DESTINATION aufgerufen wird, werden Eigenschaften für die Zielzeile zurückgegeben. (Das dwSource-Element muss in diesem Fall auf 0 festgelegt werden.) Wenn sie mit dem MIXER_GETLINEINFOF_SOURCE-Flag aufgerufen werden, werden die Eigenschaften für die Quelle zurückgegeben, die vom dwSource-Member angegeben wird, das dem dwDestination-Member zugeordnet ist.

dwSource

Index für die Audioquellzeile, die dem dwDestination-Member zugeordnet ist. Das heißt, dieses Element gibt die n thAudio-Quellzeile an, die der angegebenen Audioziellinie zugeordnet ist. Dieser Member wird nicht für Ziellinien verwendet und muss auf null festgelegt werden, wenn MIXER_GETLINEINFOF_DESTINATION in der MixerGetLineInfo-Funktion angegeben wird. Wenn das flag MIXER_GETLINEINFOF_SOURCE angegeben wird, reicht dieses Element von null bis eins kleiner als der wert, der im cConnections-Member für die Audiozielzeile angegeben ist, die im dwDestination-Member angegeben ist.

dwLineID

Ein vom Mixergerät definierter Bezeichner, der eindeutig auf die Audiozeile verweist, die von der MIXERLINE-Struktur beschrieben wird. Dieser Bezeichner ist für jedes Mixergerät eindeutig und kann in einem beliebigen Format vorliegen. Eine Anwendung sollte diesen Bezeichner nur als abstraktes Handle verwenden.

fdwLine

Status- und Supportflags für die Audiozeile. Dieser Member wird immer an die Anwendung zurückgegeben und erfordert keine Initialisierung.

Name	BESCHREIBUNG
MIXERLINE_LINEF_ACTIVE	Die Audiozeile ist aktiv. Eine aktive Linie gibt an, dass wahrscheinlich ein Signal die Linie durchläuft.
MIXERLINE_LINEF_DISCONNECTED	Die Audioleitung ist getrennt. Die zugehörigen Steuerelemente einer getrennten Linie können weiterhin geändert werden, aber die Änderungen wirken sich erst dann aus, wenn die Leitung verbunden ist.
MIXERLINE_LINEF_SOURCE	Audioleitung ist eine Audioquelle, die einer einzelnen Audiozielleitung zugeordnet ist. Wenn dieses Flag nicht festgelegt ist, ist diese Zeile eine Audioziellinie, die 0 oder mehr Audioquellenlinien zugeordnet ist.

Wenn eine Anwendung kein Waveform-Audioausgabegerät verwendet, ist die diesem Gerät zugeordnete Audioleitung nicht aktiv (d. a. das MIXERLINE_LINEF_ACTIVE Flag wird nicht festgelegt).

Wenn das Waveform-Audioausgabegerät geöffnet wird, wird die Audioleitung als aktiv betrachtet, und das flag MIXERLINE_LINEF_ACTIVE wird festgelegt.

Ein angehaltenes oder ausgehungertes Waveform-Audioausgabegerät gilt weiterhin als aktiv. Anders ausgedrückt: Wenn das Waveform-Audioausgabegerät von einer Anwendung geöffnet wird, unabhängig davon, ob Daten wiedergegeben werden, gilt die zugehörige Audioleitung als aktiv.

Wenn eine Linie nicht streng als aktiv definiert werden kann, legt das Mischgerät immer das flag MIXERLINE_LINEF_ACTIVE fest.

dwUser

Instanzdaten, die vom Audiogerät für die Leitung definiert werden. Dieses Element ist für benutzerdefinierte Mixeranwendungen vorgesehen, die speziell für das Mixergerät entwickelt wurden, das diese Informationen zurückgibt. Andere Anwendungen sollten diese Daten ignorieren.

dwComponentType

Komponententyp für diese Audioleitung. Eine Anwendung kann diese Informationen verwenden, um maßgeschneiderte Grafiken anzuzeigen oder nach einer bestimmten Komponente zu suchen. Wenn eine Anwendung keine Komponententypen verwendet, sollte dieser Member ignoriert werden. Dieser Member kann einer der folgenden Werte sein:

Name	BESCHREIBUNG
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	Audioleitung ist ein digitales Ziel (z. B. digitale Eingabe an ein DAT- oder CD-Audiogerät).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	Audioleitung ist ein einstellbares Ziel (Verstärkung und/oder Dämpfung), das zum Ansteuern von Kopfhörern bestimmt ist. Die meisten Audiokarten verwenden dieselbe Audiozielleitung für Lautsprecher und Kopfhörer. In diesem Fall verwendet das Mixergerät einfach den MIXERLINE_COMPONENTTYPE_DST_SPEAKERS Typ.
MIXERLINE_COMPONENTTYPE_DST_LINE	Audioleitung ist ein Ziel auf Zeilenebene (z. B. Die Eingabe der Zeilenebene von einem CD-Audiogerät), das die letzte Aufzeichnungsquelle für den Analog-Digital-Konverter (ADC) darstellt. Da die meisten Audiokarten für PCs eine Art Zugewinn für die Audioquelle für die Aufzeichnung bieten, verwendet das Mixergerät den MIXERLINE_COMPONENTTYPE_DST_WAVEIN Typ.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	Audioleitung ist ein Ziel, das für einen Monitor verwendet wird.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	Audioleitung ist ein einstellbares Ziel (Verstärkung und/oder Dämpfung), das zum Ansteuern von Lautsprechern bestimmt ist. Dies ist der typische Komponententyp für die Audioausgabe von Audiokarten für PCs.
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	Audioleitung ist ein Ziel, das an eine Telefonleitung weitergeleitet wird.
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	Audioleitung ist ein Ziel, das nicht durch einen der Standardkomponententypen definiert werden kann. Ein Mixergerät ist erforderlich, um diesen Komponententyp für Zeilenkomponententypen zu verwenden, die nicht von der Microsoft Corporation definiert wurden.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	Audioleitung ist ein Ziel, das die letzte Aufzeichnungsquelle für die Spracheingabe darstellt. Dieser Komponententyp ähnelt genau MIXERLINE_COMPONENTTYPE_DST_WAVEIN ist aber speziell für Einstellungen vorgesehen, die während der Sprachaufzeichnung/-erkennung verwendet werden. Die Unterstützung für diese Linie ist für ein Mixergerät optional. Viele Mixergeräte bieten nur MIXERLINE_COMPONENTTYPE_DST_WAVEIN.
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	Audioleitung ist ein Ziel, das die letzte Aufzeichnungsquelle für den Waveform-Audio-Input (ADC) darstellt. Diese Linie bietet in der Regel eine Art Verstärkung oder Dämpfung. Dies ist der typische Komponententyp für die Aufzeichnungslinie der meisten Audiokarten für PCs.
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	Audioleitung ist eine analoge Quelle (z. B. analoge Ausgabe von einem Videokassettenband).
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	Audioleitung ist eine Quelle, die von der zusätzlichen Audioleitung stammt. Dieser Zeilentyp ist als Quelle mit Verstärkung oder Dämpfung vorgesehen, die an das MIXERLINE_COMPONENTTYPE_DST_SPEAKERS Ziel weitergeleitet und/oder vom MIXERLINE_COMPONENTTYPE_DST_WAVEIN Ziel aufgezeichnet werden kann.
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	Audiozeile ist eine Quelle, die aus der Ausgabe einer internen Audio-CD stammt. Dieser Komponententyp wird für Audiokarten bereitgestellt, die eine Audio-Quellleitung bereitstellen, die mit einer Audio-CD (oder CD-ROM, die eine Audio-CD abspielt) verbunden werden soll.
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	Audioleitung ist eine digitale Quelle (z. B. digitale Ausgabe einer DAT- oder Audio-CD).
MIXERLINE_COMPONENTTYPE_SRC_LINE	Audioleitung ist eine Quelle auf Zeilenebene (z. B. Eine Zeilenebeneneingabe von einer externen Stereoanlage), die als optionale Aufzeichnungsquelle verwendet werden kann. Da die meisten Audiokarten für PCs eine Art Zugewinn für die Aufzeichnungsquelle bieten, verwendet das Mixergerät den MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY Typ.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	Audioleitung ist eine Mikrofonaufnahmequelle. Die meisten Audiokarten für PCs bieten mindestens zwei Arten von Aufzeichnungsquellen: eine zusätzliche Audioleitung und einen Mikrofoneingang. Eine Mikrofonaudioleitung bietet in der Regel eine gewisse Verstärkung. Audiokarten, die einen einzelnen Eingang für die Verwendung mit einem Mikrofon oder einer zusätzlichen Audioleitung verwenden, sollten den Komponententyp MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE verwenden.
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	Audioleitung ist eine Quelle, die von einem PC-Lautsprecher stammt. Mehrere Audiokarten für PCs bieten die Möglichkeit, das, was normalerweise auf dem internen Lautsprecher wiedergegeben wird, mit dem Ausgang eines Audio-Karte zu kombinieren. Einige Audiokarten unterstützen die Möglichkeit, diese Ausgabe als Aufzeichnungsquelle zu verwenden.
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	Audiozeile ist eine Quelle, die aus der Ausgabe eines internen Synthesizers stammt. Die meisten Audiokarten für PCs bieten eine Art MIDI-Synthesizer.
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	Audioleitung ist eine Quelle, die von einer eingehenden Telefonleitung stammt.
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	Audioleitung ist eine Quelle, die nicht durch einen der Standardkomponententypen definiert werden kann. Ein Mixergerät ist erforderlich, um diesen Komponententyp für Zeilenkomponententypen zu verwenden, die nicht von der Microsoft Corporation definiert wurden.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	Audioleitung ist eine Quelle, die vom DAC (Digital/Analog Converter, DAC) des Waveform-Audioausgangs stammt. Die meisten Audiokarten für PCs stellen diesen Komponententyp als Quelle für das MIXERLINE_COMPONENTTYPE_DST_SPEAKERS Ziel bereit. Bei einigen Karten kann diese Quelle auch an das MIXERLINE_COMPONENTTYPE_DST_WAVEIN Ziel weitergeleitet werden.

cChannels

Maximale Anzahl von separaten Kanälen, die unabhängig für die Audioleitung bearbeitet werden können. Der Mindestwert für dieses Feld ist 1, da eine Zeile mindestens einen Kanal aufweisen muss.

Die meisten modernen Audiokarten für PCs sind Stereogeräte; für sie ist der Wert dieses Members 2.

Kanal 1 wird als linker Kanal angenommen; Kanal 2 wird als richtiger Kanal angenommen.

Einer Mehrkanallinie kann ein oder mehrere einheitliche Steuerelemente (Steuerelemente, die alle Kanäle einer Linie gleichmäßig betreffen) zugeordnet sein.

cConnections

Anzahl der Verbindungen, die der Audioleitung zugeordnet sind. Dieser Member wird nur für Audioziellinien verwendet und gibt die Anzahl der Audioquellenzeilen an, die diesem zugeordnet sind. Dieser Member ist immer null für Quellzeilen und für Ziellinien, denen keine Audioquellenzeilen zugeordnet sind.

cControls

Anzahl der Steuerelemente, die der Audioleitung zugeordnet sind. Dieser Wert kann auch 0 sein. Wenn der Linie keine Steuerelemente zugeordnet sind, handelt es sich bei der Linie wahrscheinlich um eine Quelle, die in einem MIXERCONTROL_CONTROLTYPE_MUX oder MIXERCONTROL_CONTROLTYPE_MIXER ausgewählt werden kann, aber keine Manipulation des Signals zulässt.

szShortName[MIXER_SHORT_NAME_CHARS]

Kurze Zeichenfolge, die die Audiomischerlinie beschreibt, die im dwLineID-Element angegeben ist. Diese Beschreibung sollte als prägnante Bezeichnung für die Zeile geeignet sein.

szName[MIXER_LONG_NAME_CHARS]

Zeichenfolge, die die Audiomischerlinie beschreibt, die im dwLineID-Element angegeben ist. Diese Beschreibung sollte als vollständige Beschreibung für die Zeile geeignet sein.

Target

Zielmedieninformationen.

Target.dwType

Zielmediengerätetyp, der der Audiozeile zugeordnet ist, die in der MIXERLINE-Struktur beschrieben wird. Eine Anwendung muss Zielinformationen für nicht verwendete Mediengerätetypen ignorieren. Die folgenden Werte werden definiert:

Name	BESCHREIBUNG
MIXERLINE_TARGETTYPE_AUX	Die von der MIXERLINE-Struktur beschriebene Audiolinie ist streng an das Hilfsgerät gebunden, das in den verbleibenden Membern des Target-Strukturelements der MIXERLINE-Struktur detailliert ist.
MIXERLINE_TARGETTYPE_MIDIIN	Die von der MIXERLINE-Struktur beschriebene Audiolinie ist streng an das MIDI-Eingabegerät gebunden, das in den verbleibenden Membern des Target-Strukturelements der MIXERLINE-Struktur detailliert ist.
MIXERLINE_TARGETTYPE_MIDIOUT	Die von der MIXERLINE-Struktur beschriebene Audiolinie ist streng an das MIDI-Ausgabegerät gebunden, das in den verbleibenden Membern des Target-Strukturelements der MIXERLINE-Struktur detailliert ist.
MIXERLINE_TARGETTYPE_UNDEFINED	Die von der MIXERLINE-Struktur beschriebene Audiolinie ist nicht streng an einen definierten Medientyp gebunden. Alle verbleibenden Elemente der Zielstruktur der MIXERLINE-Struktur sollten ignoriert werden. Eine Anwendung kann den MIXERLINE_TARGETTYPE_UNDEFINED Zieltyp nicht verwenden, wenn die mixerGetLineInfo-Funktion mit dem flag MIXER_GETLINEINFOF_TARGETTYPE aufgerufen wird.
MIXERLINE_TARGETTYPE_WAVEIN	Die von der MIXERLINE-Struktur beschriebene Audiolinie ist streng an das Waveform-Audio-Eingabegerät gebunden, das in den verbleibenden Elementen des Target-Strukturelements der MIXERLINE-Struktur detailliert ist.
MIXERLINE_TARGETTYPE_WAVEOUT	Die von der MIXERLINE-Struktur beschriebene Audiolinie ist streng an das Waveform-Audioausgabegerät gebunden, das in den verbleibenden Elementen des Target-Strukturelements der MIXERLINE-Struktur beschrieben ist.

Target.dwDeviceID

Aktueller Gerätebezeichner des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Dieser Bezeichner ist mit dem aktuellen Mediengeräteindex des zugeordneten Mediengeräts identisch. Beim Aufrufen der mixerGetLineInfo-Funktion mit dem flag MIXER_GETLINEINFOF_TARGETTYPE wird dieses Element bei der Eingabe ignoriert und vom Audiomischer-Manager an den Aufrufer zurückgegeben.

Target.wMid

Herstellerbezeichner des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Dieser Bezeichner ist mit dem wMid-Member der Gerätefunktionenstruktur für die zugeordneten Medien identisch. Herstellerbezeichner sind in Hersteller- und Produktbezeichnern definiert.

Target.wPid

Produkt-ID des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Dieser Bezeichner ist mit dem wPid-Member der Gerätefunktionenstruktur für die zugeordneten Medien identisch. Produktbezeichner werden unter Hersteller- und Produktbezeichner definiert.

Target.vDriverVersion

Treiberversion des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Diese Version ist identisch mit dem vDriverVersion-Member der Gerätefunktionenstruktur für die zugehörigen Medien.

Target.szPname[MAXPNAMELEN]

Produktname des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Dieser Name ist identisch mit dem szPname-Member der Device-capabilities-Struktur für die zugeordneten Medien.

Hinweise

Hinweis

Der mmeapi.h-Header definiert MIXERLINE als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	mmeapi.h

Weitere Informationen

Audiomischerstrukturen

Audiomischer

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo

Freigeben über