Condividi tramite


Funzione AcxMuteCreate (acxelements.h)

La funzione AcxMuteCreate viene usata per creare un oggetto mute ACX che verrà associato a un elemento padre dell'oggetto circuito.

Sintassi

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

Parametri

Object

Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti framework) che verrà associato al circuito.

Attributes

Attributi aggiuntivi definiti usando una struttura di WDF_OBJECT_ATTRIBUTES utilizzata per impostare vari valori e per associare l'oggetto mute all'oggetto circuito padre.

Config

Struttura ACX_MUTE_CONFIG inizializzata che descrive la configurazione del comportamento di disattivazione automatica.

Mute

Puntatore a una posizione che riceve l'handle all'oggetto ACXMUTE appena creato. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso di valori NTSTATUS.

Osservazioni

Esempio

Di seguito è riportato un esempio di utilizzo.

    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);

Requisiti ACX

versione minima di ACX: 1.0

Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.

Fabbisogno

Requisito Valore
intestazione acxelements.h
IRQL PASSIVE_LEVEL

Vedere anche

  • intestazione acxelements.h