AcxPeakMeterCreate-Funktion (acxelements.h)
Die AcxPeakMeterCreate-Funktion wird verwendet, um ein ACX-Spitzenmeterobjekt zu erstellen, das einem übergeordneten Schaltkreisobjekt zugeordnet wird.
Syntax
NTSTATUS AcxPeakMeterCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PEAKMETER_CONFIG Config,
ACXPEAKMETER *PeakMeter
);
Parameter
Object
Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung von Framework-Objekten), das dem Schaltkreis zugeordnet wird.
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES Struktur definiert wurden, die zum Festlegen verschiedener Werte verwendet wird, und um das Peakmeter-Objekt dem übergeordneten Schaltkreisobjekt zuzuordnen.
Config
Eine initialisierte ACX_PEAKMETER_CONFIG Struktur, die die Konfiguration des Spitzenmeters der Audioebene beschreibt.
PeakMeter
Ein Zeiger auf eine Position, die den Handle auf das neu erstellte ACXPEAKMETER-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Die Beispielverwendung wird unten gezeigt.
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);
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxelements.h |
| IRQL- | PASSIVE_LEVEL |