MIXERLINEW 構造体 (mmeapi.h)
MIXERLINE 構造体は、オーディオラインの状態とメトリックを記述します。
構文
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;
メンバーズ
cbStruct
MIXERLINE 構造体のサイズ (バイト単位)。 このメンバーは、mixerGetLineInfo 関数を呼び出す前に初期化する必要があります。 このメンバーで指定するサイズは、MIXERLINE 構造体を格納するのに十分な大きさである必要があります。 mixerGetLineInfo
dwDestination
宛先行インデックス。 このメンバーの範囲は、
dwSource
dwDestination メンバーに関連付けられているオーディオ ソース行のインデックス。 つまり、このメンバーは、指定されたオーディオの宛先行に関連付けられているオーディオ ソース行n
dwLineID
MIXERLINE 構造体によって記述されたオーディオ行を一意に参照するミキサー デバイスによって定義される識別子。 この識別子は、ミキサー デバイスごとに一意であり、任意の形式にすることができます。 アプリケーションでは、この識別子を抽象ハンドルとしてのみ使用する必要があります。
fdwLine
オーディオ行の状態とサポート フラグ。 このメンバーは常にアプリケーションに返され、初期化は必要ありません。
アプリケーションが波形オーディオ出力デバイスを使用していない場合、そのデバイスに関連付けられているオーディオ行はアクティブになりません (つまり、MIXERLINE_LINEF_ACTIVE フラグは設定されません)。
波形オーディオ出力デバイスを開くと、オーディオラインがアクティブと見なされ、MIXERLINE_LINEF_ACTIVEフラグが設定されます。
一時停止または不足している波形オーディオ出力デバイスは、引き続きアクティブと見なされます。 つまり、データが再生されているかどうかに関係なく、波形オーディオ出力デバイスがアプリケーションによって開かれた場合、関連するオーディオラインはアクティブと見なされます。
ラインをアクティブとして厳密に定義できない場合、ミキサー デバイスは常に MIXERLINE_LINEF_ACTIVE フラグを設定します。
dwUser
行のオーディオ デバイスによって定義されたインスタンス データ。 このメンバーは、この情報を返すミキサー デバイス専用に設計されたカスタム ミキサー アプリケーションを対象としています。 他のアプリケーションでは、このデータを無視する必要があります。
dwComponentType
このオーディオ行のコンポーネントの種類。 アプリケーションは、この情報を使用して、調整されたグラフィックスを表示したり、特定のコンポーネントを検索したりすることができます。 アプリケーションでコンポーネント型を使用しない場合、このメンバーは無視する必要があります。 このメンバーには、次のいずれかの値を指定できます。
cChannels
オーディオ ラインに対して個別に操作できる個別のチャネルの最大数。 行には少なくとも 1 つのチャネルが必要であるため、このフィールドの最小値は 1 です。
パーソナルコンピュータ用の最新のオーディオカードのほとんどはステレオデバイスです。これらのメンバーの場合、このメンバーの値は 2 です。
チャネル 1 は左側のチャネルと見なされます。チャネル 2 が適切なチャネルであると見なされます。
マルチチャネル回線には、1 つ以上の均一なコントロール (線のすべてのチャネルに均一に影響を与えるコントロール) が関連付けられている場合があります。
cConnections
オーディオ行に関連付けられている接続の数。 このメンバーは、オーディオ変換先の行にのみ使用され、それに関連付けられているオーディオ ソース行の数を指定します。 このメンバーは、ソース行と、オーディオ ソース行が関連付けられていない宛先行の場合、常に 0 です。
cControls
オーディオ行に関連付けられているコントロールの数。 この値には 0 を指定できます。 ラインに関連付けられているコントロールがない場合、ラインは、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 構造体によって記述されるオーディオラインは、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以外のターゲットの種類である場合のターゲット メディア デバイスの製品名。 この名前は、関連付けられたメディアのデバイス機能構造の szPname メンバーと同じです。
備考
手記
mmeapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MIXERLINE を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー | mmeapi.h |
関連項目
オーディオ ミキサー構造 を
オーディオ ミキサー
mixerGetDevCaps を
mixerGetLineInfo を