Share via

structure ACX_EVENT_CONFIG (acxevents.h)

  • Article

La structure ACX_EVENT_CONFIG est utilisée pour configurer un ACXEVENT.

Syntaxe

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;

Membres

Size

Longueur, en octets, de cette structure.

Flags

OR au niveau du bit de ACX_PNPEVENT_CONFIG_FLAGS.

Set

Spécifie le jeu d’événements. Ce membre est un pointeur vers un GUID qui identifie de manière unique le jeu d’événements. Consultez la liste des GUID d’ensembles d’événements dans Les ensembles d’événements de pilotes audio.

Il s’agit d’un KSEVENTSETID, par exemple KSEVENTSETID_AudioControlChange. Pour plus d’informations sur, consultez Structure KSEVENTDATA (ks.h).

Id

Spécifie l’ID d’événement. Ce membre identifie un élément d’événement dans le jeu d’événements. Si le jeu d’événements contient N éléments, les ID d’événement valides sont des entiers compris entre 0 et N-1.

Type

Le type de valeur d’événement (données d’opération) est une structure KSEVENTDATA qui spécifie la méthode de notification à utiliser pour cet événement.

Callbacks

La structure ACX_EVENT_CALLBACKS qui identifie les rappels de pilotes pour les opérations d’événement ACX.

Remarques

Exemple

L’exemple montre comment ACX utilise la structure 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;

Configuration requise d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxevents.h

Voir aussi