MIXERLINECONTROLSW 構造体 (mmeapi.h)

[アーティクル]
11/20/2024

MIXERLINECONTROLS 構造体には、オーディオ行のコントロールに関する情報が含まれています。

構文

typedef struct tagMIXERLINECONTROLSW {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLW pamxctrl;
} MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW;

メンバーズ

cbStruct

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

dwLineID

クエリ対象のコントロールの行識別子。 mixerGetLineControls 関数にMIXER_GETLINECONTROLSF_ONEBYID フラグが指定されている場合、このメンバーは使用されませんが、この場合もミキサーデバイスはこのメンバーを返します。 dwControlID および dwControlType メンバー MIXER_GETLINECONTROLSF_ALL指定されている場合は使用されません。

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

目的のコントロールのコントロール識別子。このメンバーは、指定したコントロールのコントロール情報を取得するために、mixerGetLineControls 関数のMIXER_GETLINECONTROLSF_ONEBYID フラグと共に使用されます。 MIXERLINECONTROLS 構造体の dwLineID メンバーはミキサーデバイスによって返され、入力パラメーターとして必要になることに注意してください。このメンバーは、dwControlType メンバーと重複しており、MIXER_GETLINECONTROLSF_ONEBYTYPEクエリ型と組み合わせて使用することはできません。

DUMMYUNIONNAME.dwControlType

目的のコントロール型のクラス。このメンバーは、mixerGetLineControls 関数のMIXER_GETLINECONTROLSF_ONEBYTYPE フラグと共に使用され、MIXERLINECONTROLS 構造体の dwLineID メンバーによって指定された行の指定されたクラスの最初のコントロールを取得します。このメンバーは、dwControlID メンバーと重複しており、MIXER_GETLINECONTROLSF_ONEBYID クエリの種類と組み合わせて使用することはできません。 MIXERCONTROLの dwControlType メンバーの説明参照してください。

cControls

取得する MIXERCONTROL 構造体要素の数。このメンバーは、mixerGetLineControls 関数を呼び出す前に、アプリケーションによって初期化される必要があります。このメンバーは、MIXER_GETLINECONTROLSF_ONEBYIDまたはMIXER_GETLINECONTROLSF_ONEBYTYPEが指定されている場合、またはオーディオ行に対して返される MIXERLINE 構造体の cControls メンバーで返される値である場合にのみ、1 にすることができます。このメンバーを 0 にすることはできません。オーディオ行にコントロールがないことを指定する場合は、mixerGetLineControls 呼び出さないでください。

cbmxctrl

MIXERCONTROL 構造体の 1 つののサイズ (バイト単位)。このメンバーで指定するサイズは、基本 MIXERCONTROL 構造体を格納するのに十分な大きさにする必要があります。 pamxctrl メンバーが指すバッファーに必要な合計サイズ (バイト単位) は、MIXERLINECONTROLS 構造体の cbmxctrl および cControls メンバーの積です。

pamxctrl

要求されたオーディオラインコントロールのプロパティを受け取る 1 つ以上の MIXERCONTROL 構造体へのポインター。このメンバーは NULL できず、mixerGetLineControls 関数を呼び出す前に初期化する必要があります。コントロールの配列の各要素は、MIXERCONTROL 構造体の基本含めるのに十分な大きさにする必要があります。 cbmxctrl メンバーは、この配列内の各要素のサイズ (バイト単位) を指定する必要があります。このメンバーが指すバッファーの初期化は、アプリケーションで必要ありません。正常に戻ると、すべてのメンバーがミキサーデバイス (各 MIXERCONTROL 構造体の cbStruct メンバーを含む) によって入力されます。

備考

手記

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

必要条件

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

次の方法で共有

MIXERLINECONTROLSW 構造体 (mmeapi.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース