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

位 OR ACX_PNPEVENT_CONFIG_FLAGS。

Set

指定事件集。 這個成員是 GUID 的指標，可唯一識別事件集。 請參閱 音訊驅動程式事件集中的事件集 GUID 清單。

這是 KSEVENTSETID，例如KSEVENTSETID_AudioControlChange。 如需詳細資訊，請參閱 ks.h (ks.h) KSEVENTDATA 結構 。

Id

指定事件識別碼。 此成員會識別事件集內的事件專案。 如果事件集包含 N 個專案，則有效的事件標識碼是範圍 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 版本概觀。

規格需求

另請參閱

• acxevents.h 標頭