AcxPeakMeterCreate-Funktion (acxelements.h)

Artikel
02/26/2024

Die AcxPeakMeterCreate-Funktion wird verwendet, um ein ACX-Peakmeter-Objekt zu erstellen, das einem übergeordneten Leitungsobjekt 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 der Frameworkobjekte), das der Verbindung zugeordnet wird.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert werden, die verwendet werden, um verschiedene Werte festzulegen und das Peakmeter-Objekt dem übergeordneten Leitungsobjekt zuzuordnen.

Config

Eine initialisierte ACX_PEAKMETER_CONFIG Struktur , die die Konfiguration des Audiopegelspitzenmessers beschreibt.

PeakMeter

Ein Zeiger auf eine Position, die das Handle auf das neu erstellte ACXPEAKMETER-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

Die Verwendungsbeispiele finden Sie unten.

    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

AcX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung	Wert
Header	acxelements.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

acxelements.h-Header

Freigeben über