Share via

ACX_EVENT_CONFIG 構造体 (acxevents.h)

  • [アーティクル]

ACX_EVENT_CONFIG構造体は、ACXEVENT を構成するために使用されます。

構文

typedef struct _ACX_EVENT_CONFIG {
  ULONG                Size;
  ULONG                Flags;
  const GUID           *Set;
  ULONG                Id;
  ULONG                Type;
  PACX_EVENT_CALLBACKS Callbacks;
} ACX_EVENT_CONFIG, *PACX_EVENT_CONFIG;

メンバー

Size

この構造体の長さ (バイト単位)。

Flags

ACX_PNPEVENT_CONFIG_FLAGSのビットごとの OR。

Set

イベント セットを指定します。 このメンバーは、イベント セットを一意に識別する GUID へのポインターです。 オーディオ ドライバー イベント セットのイベント セット GUID の一覧を参照してください。

これは KSEVENTSETID (KSEVENTSETID_AudioControlChangeなど) です。 詳細については、「 KSEVENTDATA 構造体 (ks.h)」を参照してください。

Id

イベント ID を指定します。 このメンバーは、イベント セット内のイベント 項目を識別します。 イベント セットに N 個の項目が含まれている場合、有効なイベント ID は 0 から N-1 の範囲の整数です。

Type

イベント値の種類 (操作データ) は、このイベントに使用する通知メソッドを指定する KSEVENTDATA 構造体 です。

Callbacks

ACX イベント操作のドライバー コールバックを識別する ACX_EVENT_CALLBACKS構造体 。

解説

例

この例では、ACX がACX_EVENT_CONFIG構造体を使用する方法を示しています。

    ACX_EVENT_CONFIG            eventCfg;
    ACX_EVENT_CALLBACKS         eventCallbacks;
 
    //
    // Add an audio control change event to this volume element.
    //
    ACX_EVENT_CALLBACKS_INIT(&eventCallbacks);
    eventCallbacks.EvtAcxEventEnable = &AfxVolume::EvtVolumeEventEnableCallback; 
    eventCallbacks.EvtAcxEventDisable = &AfxVolume::EvtVolumeEventDisableCallback;

    ACX_EVENT_CONFIG_INIT(&eventCfg);
    eventCfg.Set = &KSEVENTSETID_AudioControlChange;
    eventCfg.Id  = KSEVENT_CONTROL_CHANGE;
    eventCfg.Callbacks = &eventCallbacks;

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。

要件

要件 値
Header acxevents.h

こちらもご覧ください