次の方法で共有


MIXERLINEA 構造体 (mmeapi.h)

MIXERLINE 構造体は、オーディオラインの状態とメトリックを記述します。

構文

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;

メンバー

cbStruct

MIXERLINE 構造体のサイズ (バイト単位)。 このメンバーは、 mixerGetLineInfo 関数を呼び出す前に初期化する必要があります。 このメンバーで指定するサイズは 、MIXERLINE 構造体を格納するのに十分な大きさである必要があります。 mixerGetLineInfo が返されると、このメンバーには、返される情報の実際のサイズが含まれます。 返される情報は、要求されたサイズを超えるものではありません。

dwDestination

宛先行インデックス。 このメンバーの範囲は、mixerGetDevCaps 関数によって取得された MIXERCAPS 構造体の cDestinations メンバーで指定された値より 0 から 1 未満です。 MIXER_GETLINEINFOF_DESTINATION フラグを指定して mixerGetLineInfo 関数を呼び出すと、変換先行のプロパティが返されます。 (この場合、dwSource メンバーは 0 に設定する必要があります)。MIXER_GETLINEINFOF_SOURCE フラグを指定して呼び出されると、dwDestination メンバーに関連付けられている dwSource メンバーによって指定されたソースのプロパティが返されます。

dwSource

dwDestination メンバーに関連付けられているオーディオ ソース行のインデックス。 つまり、このメンバーは、指定されたオーディオ宛先行に関連付けられている n番目のオーディオ ソース行を指定します。 このメンバーは変換先行には使用されず、 mixerGetLineInfo 関数でMIXER_GETLINEINFOF_DESTINATIONが指定されている場合は 0 に設定する必要があります。 MIXER_GETLINEINFOF_SOURCE フラグを指定すると、このメンバーの範囲は、dwDestination メンバーで指定されたオーディオ宛先行の cConnections メンバーで指定された値より 0 から 1 未満になります。

dwLineID

MIXERLINE 構造体によって記述されたオーディオ行を一意に参照するミキサー デバイスによって定義される識別子。 この識別子は、ミキサー デバイスごとに一意であり、任意の形式にすることができます。 アプリケーションでは、この識別子を抽象ハンドルとしてのみ使用する必要があります。

fdwLine

オーディオ行の状態フラグとサポート フラグ。 このメンバーは常にアプリケーションに返され、初期化は必要ありません。

名前 説明
MIXERLINE_LINEF_ACTIVE
オーディオラインがアクティブです。 アクティブな行は、信号がラインを通過している可能性があることを示します。
MIXERLINE_LINEF_DISCONNECTED
オーディオラインが切断されています。 切断された行の関連付けられたコントロールは変更できますが、その変更は行が接続されるまで有効になりません。
MIXERLINE_LINEF_SOURCE
オーディオラインは、単一のオーディオ宛先行に関連付けられたオーディオソースラインです。 このフラグが設定されていない場合、この行は、0 個以上のオーディオ ソース行に関連付けられているオーディオ変換先の行です。
 

アプリケーションが波形オーディオ出力デバイスを使用していない場合、そのデバイスに関連付けられているオーディオ行はアクティブになりません (つまり、MIXERLINE_LINEF_ACTIVE フラグは設定されません)。

波形オーディオ出力デバイスを開くと、オーディオラインがアクティブと見なされ、MIXERLINE_LINEF_ACTIVEフラグが設定されます。

一時停止または枯渇した波形オーディオ出力デバイスは、引き続きアクティブと見なされます。 つまり、データが再生されているかどうかに関係なく、波形オーディオ出力デバイスがアプリケーションによって開かれた場合、関連するオーディオラインはアクティブと見なされます。

ラインをアクティブとして厳密に定義できない場合、ミキサーデバイスは常にMIXERLINE_LINEF_ACTIVEフラグを設定します。

dwUser

行のオーディオ デバイスによって定義されたインスタンス データ。 このメンバーは、この情報を返すミキサーデバイス専用に設計されたカスタムミキサーアプリケーションを対象としています。 他のアプリケーションでは、このデータを無視する必要があります。

dwComponentType

このオーディオラインのコンポーネントの種類。 アプリケーションでは、この情報を使用して、調整されたグラフィックスを表示したり、特定のコンポーネントを検索したりすることができます。 アプリケーションでコンポーネント型を使用しない場合、このメンバーは無視する必要があります。 このメンバーには、次のいずれかの値を指定できます。

名前 説明
MIXERLINE_COMPONENTTYPE_DST_DIGITAL
オーディオラインはデジタル変換先です (DAT や CD オーディオ デバイスへのデジタル入力など)。
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES
オーディオラインは、ヘッドフォンを駆動することを目的とした調整可能な(ゲインや減衰)先です。 ほとんどのオーディオ カードでは、スピーカーとヘッドホンに同じオーディオ変換先ラインが使用されます。その場合、ミキサー デバイスは単にMIXERLINE_COMPONENTTYPE_DST_SPEAKERSタイプを使用します。
MIXERLINE_COMPONENTTYPE_DST_LINE
オーディオラインは、アナログデジタルコンバータ(ADC)の最終的な録音ソースとなるラインレベルの宛先(CDオーディオデバイスからのラインレベル入力など)です。 パーソナル コンピュータのほとんどのオーディオ カードは、録音オーディオ ソースラインに何らかのゲインを提供するため、ミキサーデバイスはMIXERLINE_COMPONENTTYPE_DST_WAVEINタイプを使用します。
MIXERLINE_COMPONENTTYPE_DST_MONITOR
オーディオラインは、モニターに使用される宛先です。
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS
オーディオラインは、スピーカーを駆動することを目的とした調整可能な(ゲインおよび/または減衰)宛先です。 これは、パーソナル コンピューターのオーディオ カードのオーディオ出力の一般的なコンポーネントの種類です。
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE
音声回線は、電話回線にルーティングされる宛先です。
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED
オーディオラインは、標準コンポーネントタイプのいずれかで定義できない宛先です。 このコンポーネントの種類を Microsoft Corporation で定義されていないライン コンポーネントの種類に使用するには、ミキサー デバイスが必要です。
MIXERLINE_COMPONENTTYPE_DST_VOICEIN
オーディオラインは、音声入力の最終的な録音ソースとなる宛先です。 このコンポーネントの種類は、MIXERLINE_COMPONENTTYPE_DST_WAVEINとまったく同じですが、音声録音/認識中に使用される設定専用です。 このラインのサポートは、ミキサー デバイスでは省略可能です。 多くのミキサー デバイスでは、MIXERLINE_COMPONENTTYPE_DST_WAVEINのみが提供されます。
MIXERLINE_COMPONENTTYPE_DST_WAVEIN
オーディオラインは、波形オーディオ入力(ADC)の最終的な録音ソースとなる宛先です。 このラインは通常、何らかのゲインまたは減衰を提供します。 これは、パーソナル コンピューター用のほとんどのオーディオ カードの録音ラインの一般的なコンポーネントの種類です。
MIXERLINE_COMPONENTTYPE_SRC_ANALOG
オーディオラインはアナログソース(ビデオカセットテープからのアナログ出力など)です。
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY
オーディオラインは、補助オーディオラインから発信されるソースです。 このライン タイプは、ゲインまたは減衰を持つソースとして意図されており、MIXERLINE_COMPONENTTYPE_DST_SPEAKERSの宛先にルーティングしたり、MIXERLINE_COMPONENTTYPE_DST_WAVEINの宛先から記録したりできます。
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC
オーディオラインは、内部オーディオCDの出力から発信されるソースです。 このコンポーネントの種類は、オーディオ CD (またはオーディオ CD を再生する CD-ROM) に接続することを目的としたオーディオ ソース行を提供するオーディオ カード用に提供されます。
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL
オーディオ ラインは、デジタル ソース (DAT やオーディオ CD からのデジタル出力など) です。
MIXERLINE_COMPONENTTYPE_SRC_LINE
オーディオラインは、オプションの録音ソースとして使用できるラインレベルのソース(外部ステレオからのラインレベル入力など)です。 パーソナル コンピュータのほとんどのオーディオ カードは、録音ソースラインに何らかのゲインを提供するため、ミキサーデバイスはMIXERLINE_COMPONENTTYPE_SRC_AUXILIARYタイプを使用します。
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE
オーディオラインはマイク録音ソースです。 パーソナル コンピューター用のほとんどのオーディオ カードは、少なくとも 2 種類の録音ソース (補助オーディオ ラインとマイク入力) を提供します。 マイクオーディオラインは通常、何らかのゲインを提供します。 マイクまたは補助オーディオラインで使用するために 1 つの入力を使用するオーディオ カードでは、MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE コンポーネントの種類を使用する必要があります。
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER
オーディオ ラインは、パーソナル コンピューターのスピーカーから発信されるソースです。 パーソナル コンピューター用のいくつかのオーディオ カードでは、内部スピーカーで通常再生されるものとオーディオ カードの出力を混在させる機能が用意されています。 一部のオーディオ カードでは、この出力を録音ソースとして使用する機能がサポートされています。
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER
オーディオラインは、内部シンセサイザーの出力から発信されるソースです。 パーソナルコンピュータ用のほとんどのオーディオカードは、MIDIシンセサイザーのいくつかの種類を提供します。
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE
音声回線は、着信電話回線から発信されるソースです。
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED
オーディオラインは、標準コンポーネントの種類の 1 つでは定義できないソースです。 Microsoft Corporation で定義されていないライン コンポーネントの種類に対してこのコンポーネントの種類を使用するには、ミキサー デバイスが必要です。
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT
オーディオラインは、波形オーディオ出力デジタルアナログコンバータ(DAC)から発信されるソースです。 パーソナル コンピューターのほとんどのオーディオ カードは、このコンポーネントの種類をMIXERLINE_COMPONENTTYPE_DST_SPEAKERSの宛先へのソースとして提供します。 一部のカードでは、このソースをMIXERLINE_COMPONENTTYPE_DST_WAVEIN宛先にルーティングすることもできます。

cChannels

オーディオ行に対して個別に操作できる個別のチャネルの最大数。 行には少なくとも 1 つのチャネルが必要であるため、このフィールドの最小値は 1 です。

パーソナル コンピューター用の最新のオーディオ カードのほとんどは、ステレオ デバイスです。これらのメンバーの場合、このメンバーの値は 2 です。

チャネル 1 は左側のチャネルと見なされます。チャネル 2 が適切なチャネルであると見なされます。

マルチチャネル行には、1 つ以上の均一なコントロール (一様に行のすべてのチャネルに影響を与えるコントロール) が関連付けられている場合があります。

cConnections

オーディオ行に関連付けられている接続の数。 このメンバーは、オーディオの宛先行にのみ使用され、それに関連付けられているオーディオ ソース行の数を指定します。 このメンバーは、ソース行と、オーディオ ソース行が関連付けられていない宛先行の場合、常に 0 です。

cControls

オーディオ行に関連付けられているコントロールの数。 この値はゼロの場合があります。 ラインにコントロールが関連付けられていない場合、ラインは、MIXERCONTROL_CONTROLTYPE_MUXまたはMIXERCONTROL_CONTROLTYPE_MIXERで選択される可能性がありますが、シグナルの操作は許可されないソースである可能性があります。

szShortName[MIXER_SHORT_NAME_CHARS]

dwLineID メンバーで指定されたオーディオ ミキサー行を表す短い文字列。 この説明は、行の簡潔なラベルとして適切である必要があります。

szName[MIXER_LONG_NAME_CHARS]

dwLineID メンバーで指定されたオーディオ ミキサー行を表す文字列。 この説明は、行の完全な説明として適切である必要があります。

Target

ターゲット メディア情報。

Target.dwType

MIXERLINE 構造体で説明されているオーディオ行に関連付けられているターゲット メディア デバイスの種類。 アプリケーションは、使用しないメディア デバイスの種類のターゲット情報を無視する必要があります。 次の値が定義されています。

名前 説明
MIXERLINE_TARGETTYPE_AUX
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーに詳細な補助 デバイスに厳密 にバインドされます。
MIXERLINE_TARGETTYPE_MIDIIN
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な MIDI 入力 デバイスに厳密 にバインドされます。
MIXERLINE_TARGETTYPE_MIDIOUT
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な MIDI 出力 デバイスに厳密 にバインドされます。
MIXERLINE_TARGETTYPE_UNDEFINED
MIXERLINE 構造体によって記述されるオーディオ行は、定義されたメディアの種類に厳密にバインドされていません。 MIXERLINE 構造体の残りの Target 構造体メンバーはすべて無視する必要があります。 MIXER_GETLINEINFOF_TARGETTYPE フラグを指定して mixerGetLineInfo 関数を呼び出すときに、アプリケーションでMIXERLINE_TARGETTYPE_UNDEFINEDターゲットの種類を使用することはできません。
MIXERLINE_TARGETTYPE_WAVEIN
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な波形オーディオ入力 デバイスに厳密 にバインドされます。
MIXERLINE_TARGETTYPE_WAVEOUT
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な波形オーディオ出力 デバイスに厳密 にバインドされます。

Target.dwDeviceID

dwType メンバーがMIXERLINE_TARGETTYPE_UNDEFINED以外のターゲットの種類である場合のターゲット メディア デバイスの現在のデバイス識別子。 この識別子は、関連付けられているメディア デバイスの現在のメディア デバイス インデックスと同じです。 MIXER_GETLINEINFOF_TARGETTYPE フラグを指定して mixerGetLineInfo 関数を呼び出すと、このメンバーは入力時に無視され、オーディオ ミキサー マネージャーによって呼び出し元に返されます。

Target.wMid

dwType メンバーがMIXERLINE_TARGETTYPE_UNDEFINED以外のターゲットの種類である場合のターゲット メディア デバイスの製造元識別子。 この識別子は、関連付けられているメディアのデバイス機能構造の wMid メンバーと同じです。 製造元識別子は、 製造元と製品識別子で定義されています。

Target.wPid

dwType メンバーがMIXERLINE_TARGETTYPE_UNDEFINED以外のターゲットの種類である場合のターゲット メディア デバイスの製品識別子。 この識別子は、関連付けられているメディアのデバイス機能構造体の wPid メンバーと同じです。 製品識別子は、 製造元と製品識別子で定義されています。

Target.vDriverVersion

dwType メンバーがMIXERLINE_TARGETTYPE_UNDEFINED以外のターゲットの種類である場合のターゲット メディア デバイスのドライバー バージョン。 このバージョンは、関連付けられているメディアのデバイス機能構造の vDriverVersion メンバーと同じです。

Target.szPname[MAXPNAMELEN]

dwType メンバーがMIXERLINE_TARGETTYPE_UNDEFINED以外のターゲットの種類である場合のターゲット メディア デバイスの製品名。 この名前は、関連付けられているメディアの device-capabilities 構造体の szPname メンバーと同じです。

注釈

注意

mmeapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MIXERLINE を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header mmeapi.h

こちらもご覧ください

オーディオ ミキサーの構造

オーディオ ミキサー

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo