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_ACTIVEフラグが設定されます。

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

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

dwUser

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

dwComponentType

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

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

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 メンバーと同じです。

注釈

要件

こちらもご覧ください

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

オーディオ ミキサー

MIXERCAPS

mixerGetDevCaps

mixerGetLineInfo