AcxMuteCreate, fonction (acxelements.h)

  • Article

La fonction AcxMuteCreate est utilisée pour créer un objet de désactivation ACX qui sera associé à un objet de circuit parent.

Syntaxe

NTSTATUS AcxMuteCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_MUTE_CONFIG       Config,
  ACXMUTE                *Mute
);

Paramètres

Object

Objet WDFDEVICE (décrit dans Résumé des objets framework) qui sera associé au circuit.

Attributes

Attributs supplémentaires définis à l’aide d’une structure de WDF_OBJECT_ATTRIBUTES qui sont utilisés pour définir diverses valeurs et associer l’objet mute à l’objet de circuit parent.

Config

Structure ACX_MUTE_CONFIG initialisée qui décrit la configuration du comportement de sourdine.

Mute

Pointeur vers un emplacement qui reçoit le handle vers l’objet ACXMUTE nouvellement créé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Remarques

Exemple

L’exemple d’utilisation est illustré ci-dessous.

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;

    ACX_MUTE_CALLBACKS              muteCallbacks;
    ACX_MUTE_CONFIG                 muteCfg;
    ACXMUTE                         muteElement;

    ACX_MUTE_CALLBACKS_INIT(&muteCallbacks);
    muteCallbacks.EvtAcxMuteAssignState = CodecR_EvtMuteAssignState;
    muteCallbacks.EvtAcxMuteRetrieveState = CodecR_EvtMuteRetrieveState;

    ACX_MUTE_CONFIG_INIT(&muteCfg);
    muteCfg.ChannelsCount = MAX_CHANNELS;
    muteCfg.Name = &KSAUDFNAME_WAVE_MUTE;
    muteCfg.Callbacks = &muteCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_MUTE_ELEMENT_CONTEXT);
    attributes.ParentObject = Circuit;

    status = AcxMuteCreate(Circuit, &attributes, &muteCfg, &muteElement);

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 acxelements.h
IRQL PASSIVE_LEVEL

Voir aussi