ACX_EVENT_CONFIG structure (acxevents.h)

Artikel
02/22/2024

The ACX_EVENT_CONFIG structure is used to configure an ACXEVENT.

Syntax

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;

Members

Size

The length, in bytes, of this structure.

Flags

Bitwise OR of ACX_PNPEVENT_CONFIG_FLAGS.

Set

Specifies the event set. This member is a pointer to a GUID that uniquely identifies the event set. See the list of event-set GUIDs in Audio Drivers Event Sets.

This is a KSEVENTSETID, for example KSEVENTSETID_AudioControlChange. For more information about, see KSEVENTDATA structure (ks.h).

Id

Specifies the event ID. This member identifies an event item within the event set. If the event set contains N items, valid event IDs are integers in the range 0 to N-1.

Type

The event value type (operation data) is a KSEVENTDATA structure that specifies the notification method to use for this event.

Callbacks

The ACX_EVENT_CALLBACKS structure that identifies the driver callbacks for ACX event operations.

Remarks

Example

The example shows how ACX uses the ACX_EVENT_CONFIG structure.

    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 requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement	Value
Header	acxevents.h

Delen via