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 構造体で説明されているオーディオ行に関連付けられているターゲット メディア デバイスの種類。 アプリケーションは、使用しないメディア デバイスの種類のターゲット情報を無視する必要があります。 次の値が定義されています。
| 名前 | 説明 |
|---|---|
|
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーに詳細な補助 デバイスに厳密 にバインドされます。 |
|
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な MIDI 入力 デバイスに厳密 にバインドされます。 |
|
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な MIDI 出力 デバイスに厳密 にバインドされます。 |
|
MIXERLINE 構造体によって記述されるオーディオ行は、定義されたメディアの種類に厳密にバインドされていません。 MIXERLINE 構造体の残りの Target 構造体メンバーはすべて無視する必要があります。 MIXER_GETLINEINFOF_TARGETTYPE フラグを指定して mixerGetLineInfo 関数を呼び出すときに、アプリケーションでMIXERLINE_TARGETTYPE_UNDEFINEDターゲットの種類を使用することはできません。 |
|
MIXERLINE 構造体によって記述されるオーディオラインは、 MIXERLINE 構造体の Target 構造体メンバーの残りのメンバーで詳細な波形オーディオ入力 デバイスに厳密 にバインドされます。 |
|
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 |
こちらもご覧ください
オーディオ ミキサー