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 |