MIXERLINEW-Struktur (mmeapi.h)

Artikel
03/06/2024

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

Syntax

typedef struct tagMIXERLINEW {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  WCHAR     szShortName[MIXER_SHORT_NAME_CHARS];
  WCHAR     szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    WCHAR     szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEW, *PMIXERLINEW, *LPMIXERLINEW;

Member

cbStruct

Größe der MIXERLINE-Struktur in Byte. Dieser Member muss initialisiert werden, bevor die MixerGetLineInfo-Funktion 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 im cDestinations-Member der MIXERCAPS-Struktur angegebene Wert, 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 flag MIXER_GETLINEINFOF_SOURCE aufgerufen wird, 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-Element zugeordnet ist. Das heißt, dieser Member gibt die nth Audio-Quellzeile an, die der angegebenen Audiozielzeile zugeordnet ist. Dieser Member wird nicht für Zielzeilen 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 0 bis 1 kleiner als der wert, der im cConnections-Element für die Audiozielzeile angegeben ist, die im dwDestination-Element angegeben ist.

dwLineID

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

fdwLine

Status- und Unterstützungsflags 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 wird getrennt. Die zugehörigen Steuerelemente einer getrennten Leitung können weiterhin geändert werden, aber die Änderungen haben keine Auswirkungen, bis die Leitung verbunden ist.
MIXERLINE_LINEF_SOURCE	Die Audiozeile ist eine Audioquellzeile, die einer einzelnen Audiozielzeile zugeordnet ist. Wenn dieses Flag nicht festgelegt ist, handelt es sich bei dieser Zeile um eine Audiozielzeile, die null oder mehr Audioquellenzeilen zugeordnet ist.

Wenn eine Anwendung kein Waveform-Audio-Ausgabegerät verwendet, wäre die diesem Gerät zugeordnete Audioleitung nicht aktiv (d. a. das flag MIXERLINE_LINEF_ACTIVE wäre nicht festgelegt).

Wenn das Waveform-Audioausgabegerät geöffnet wird, wird die Audiozeile 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, wird die zugehörige Audioleitung als aktiv betrachtet.

Wenn eine Linie nicht streng als aktiv definiert werden kann, setzt das Mixergerät immer das flag MIXERLINE_LINEF_ACTIVE.

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 Audiozeile. 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. digitaler Eingang zu einem DAT- oder CD-Audiogerät).
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	Audioleitung ist ein einstellbares Ziel (Verstärkung und/oder Dämpfung) zum Antreiben von Kopfhörern. 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	Die Audiozeile ist ein Ziel auf Zeilenebene (z. B. die Zeilenebeneneingabe von einem CD-Audiogerät), das die endgültige Aufnahmequelle für den Analog-Digital-Konverter (ADC) darstellt. Da die meisten Audiokarten für PCs eine Art Von Gewinn für die Audioquelle für die Aufzeichnung bieten, verwendet das Mixergerät den MIXERLINE_COMPONENTTYPE_DST_WAVEIN Typ.
MIXERLINE_COMPONENTTYPE_DST_MONITOR	Audiozeile ist ein Ziel, das für einen Monitor verwendet wird.
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	Audiolinie ist ein einstellbares Ziel (Verstärkung und/oder Dämpfung), das zum Antreiben 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	Audiozeile ist ein Ziel, das nicht durch einen der Standardkomponententypen definiert werden kann. Ein Mixergerät muss diesen Komponententyp für Zeilenkomponententypen verwenden, die nicht von der Microsoft Corporation definiert wurden.
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	Audioleitung ist ein Ziel, das die endgültige Aufnahmequelle für die Spracheingabe ist. Dieser Komponententyp entspricht genau MIXERLINE_COMPONENTTYPE_DST_WAVEIN ist jedoch speziell für Einstellungen vorgesehen, die während der Sprachaufzeichnung/Spracherkennung 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 endgültige Aufnahmequelle für den Waveform-Audio-Eingang (ADC) ist. Diese Linie bietet in der Regel eine Art von Gewinn 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	Die Audiozeile ist eine Quelle, die von der Hilfsaudioleitung stammt. Dieser Zeilentyp ist als Quelle mit Verstärkung oder Dämpfung gedacht, 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 Audioquellleitung 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	Audiozeile ist eine Quelle auf Zeilenebene (z. B. ein Eingang auf Zeilenebene von einem externen Stereo), die als optionale Aufnahmequelle verwendet werden kann. Da die meisten Audiokarten für PCs eine Art Von Gewinn für die Aufzeichnungsquellleitung bieten, verwendet das Mixergerät den typ MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY.
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	Audioleitung ist eine Mikrofonaufnahmequelle. Die meisten Audiokarten für PCs bieten mindestens zwei Arten von Aufnahmequellen: 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 vom PC-Lautsprecher stammt. Mehrere Audiokarten für PCs bieten die Möglichkeit, das, was normalerweise auf dem internen Lautsprecher wiedergegeben wird, mit der Ausgabe eines Audio-Karte zu mischen. Einige Audiokarten unterstützen die Möglichkeit, diese Ausgabe als Aufnahmequelle 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	Audiozeile ist eine Quelle, die nicht durch einen der Standardkomponententypen definiert werden kann. Ein Mixergerät muss diesen Komponententyp für Zeilenkomponententypen verwenden, die nicht von der Microsoft Corporation definiert wurden.
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	Die Audioleitung ist eine Quelle, die vom Digital-Zu-Analog-Wandler (DAC) stammt. Die meisten Audiokarten für PCs stellen diesen Komponententyp als Quelle für das MIXERLINE_COMPONENTTYPE_DST_SPEAKERS Ziel bereit. Einige Karten ermöglichen auch die Weiterleitung dieser Quelle an das MIXERLINE_COMPONENTTYPE_DST_WAVEIN Ziel.

cChannels

Maximale Anzahl separater Kanäle, 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; Es wird davon ausgegangen, dass kanal 2 der richtige Kanal ist.

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

cConnections

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

cControls

Anzahl der Steuerelemente, die der Audiozeile zugeordnet sind. Dieser Wert kann auch 0 sein. Wenn der Zeile keine Steuerelemente zugeordnet sind, ist die Zeile wahrscheinlich eine Quelle, die möglicherweise in einem MIXERCONTROL_CONTROLTYPE_MUX oder MIXERCONTROL_CONTROLTYPE_MIXER ausgewählt wird, aber keine Bearbeitung des Signals zulässt.

szShortName[MIXER_SHORT_NAME_CHARS]

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

szName[MIXER_LONG_NAME_CHARS]

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

Target

Zielmedieninformationen.

Target.dwType

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

Name	BESCHREIBUNG
MIXERLINE_TARGETTYPE_AUX	Die von der MIXERLINE-Struktur beschriebene Audiozeile ist streng an das Hilfsgerät gebunden, das in den verbleibenden Membern des Target-Strukturelements der MIXERLINE-Struktur beschrieben ist.
MIXERLINE_TARGETTYPE_MIDIIN	Die durch die 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 Audiozeile ist streng an das MIDI-Ausgabegerät gebunden, das in den verbleibenden Membern des Target-Strukturelements der MIXERLINE-Struktur angegeben ist.
MIXERLINE_TARGETTYPE_UNDEFINED	Die von der MIXERLINE-Struktur beschriebene Audiozeile ist nicht streng an einen definierten Medientyp gebunden. Alle verbleibenden Target-Strukturmember 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 Membern des Target-Strukturelements der MIXERLINE-Struktur beschrieben ist.
MIXERLINE_TARGETTYPE_WAVEOUT	Die von der MIXERLINE-Struktur beschriebene Audiozeile ist streng an das Waveform-Audio-Ausgabegerät gebunden, das in den verbleibenden Membern des Target-Strukturelements der MIXERLINE-Struktur angegeben ist.

Target.dwDeviceID

Aktueller Gerätebezeichner des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Dieser Bezeichner ist identisch mit dem aktuellen Mediengeräteindex des zugeordneten Mediengeräts. Beim Aufrufen der mixerGetLineInfo-Funktion mit dem flag MIXER_GETLINEINFOF_TARGETTYPE wird dieser Member bei der Eingabe ignoriert und vom Audiomixer-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 identisch mit dem wMid-Member der Device-capabilities-Struktur für die zugeordneten Medien. Hersteller-IDs werden unter Hersteller- und Produkt-IDs definiert.

Target.wPid

Produkt-ID des Zielmediengeräts, wenn das dwType-Element ein anderer Zieltyp als MIXERLINE_TARGETTYPE_UNDEFINED ist. Dieser Bezeichner ist identisch mit dem wPid-Member der Device-capabilities-Struktur für die zugeordneten Medien. Produktbezeichner werden unter Hersteller- und Produkt-IDs 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 Device-capabilities-Struktur für die zugeordneten 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 die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, 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

Audiomixer

Freigeben über