MIXERLINECONTROLS 構造体 (mmeapi.h)

  • [アーティクル]

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

構文

typedef struct tMIXERLINECONTROLS {
  DWORD          cbStruct;
  DWORD          dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  };
  DWORD          cControls;
  DWORD          cbmxctrl;
  LPMIXERCONTROL pamxctrl;
} MIXERLINECONTROLS, *PMIXERLINECONTROLS, *LPMIXERLINECONTROLS;

メンバー

cbStruct

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

dwLineID

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

dwControlID

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

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 メンバーを含む) によって入力されます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header mmeapi.h

関連項目

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

オーディオ ミキサー

MIXERCONTROL

MIXERLINE

mixerGetLineControls