Funzione AcxPeakMeterCreate (acxelements.h)
La funzione AcxPeakMeterCreate viene usata per creare un oggetto ACX peakmeter che verrà associato a un elemento padre dell'oggetto circuito.
Sintassi
NTSTATUS AcxPeakMeterCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PEAKMETER_CONFIG Config,
ACXPEAKMETER *PeakMeter
);
Parametri
Object
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti Framework) associato al circuito.
Attributes
Attributi aggiuntivi definiti usando una struttura WDF_OBJECT_ATTRIBUTES utilizzata per impostare vari valori e associare l'oggetto peakmeter all'oggetto circuito padre.
Config
Struttura di ACX_PEAKMETER_CONFIG inizializzata che descrive la configurazione del picco del livello audio.
PeakMeter
Puntatore a una posizione che riceve l'handle all'oggetto ACXPEAKMETER 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 dei valori NTSTATUS.
Commenti
Esempio
Di seguito è riportato l'esempio di utilizzo.
WDF_OBJECT_ATTRIBUTES attributes;
ACX_PEAKMETER_CALLBACKS peakmeterCallbacks;
ACX_PEAKMETER_CONFIG peakmeterCfg;
ACXPEAKMETER peakmeterElement;
CODEC_PEAKMETER_ELEMENT_CONTEXT*peakmeterCtx;
ACX_PEAKMETER_CALLBACKS_INIT(&peakmeterCallbacks);
peakmeterCallbacks.EvtAcxPeakMeterRetrieveLevel = CodecR_EvtPeakMeterRetrieveLevelCallback;
ACX_PEAKMETER_CONFIG_INIT(&peakmeterCfg);
peakmeterCfg.ChannelsCount = MAX_CHANNELS;
peakmeterCfg.Minimum = PEAKMETER_MINIMUM;
peakmeterCfg.Maximum = PEAKMETER_MAXIMUM;
peakmeterCfg.SteppingDelta = PEAKMETER_STEPPING_DELTA;
peakmeterCfg.Callbacks = &peakmeterCallbacks;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_PEAKMETER_ELEMENT_CONTEXT);
attributes.ParentObject = Circuit;
status = AcxPeakMeterCreate(Circuit, &attributes, &peakmeterCfg, &peakmeterElement);
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxelements.h |
| IRQL | PASSIVE_LEVEL |