MIXERLINECONTROLSW 構造体 (mmeapi.h)

  • [アーティクル]

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

1 つの MIXERCONTROL 構造体のサイズ (バイト単位)。 このメンバーで指定されるサイズは、基本 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 [デスクトップ アプリのみ]
Header mmeapi.h

関連項目

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

オーディオ ミキサー

MIXERCONTROL

MIXERLINE

mixerGetLineControls