Fungsi AcxPeakMeterCreate (acxelements.h)

Artikel
06/02/2025

Fungsi AcxPeakMeterCreate digunakan untuk membuat objek puncak ACX yang akan dikaitkan dengan induk objek sirkuit.

Sintaksis

NTSTATUS AcxPeakMeterCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_PEAKMETER_CONFIG  Config,
  ACXPEAKMETER           *PeakMeter
);

Parameter

Object

Objek WDFDEVICE (dijelaskan dalam Ringkasan Objek Kerangka Kerja) yang akan dikaitkan dengan sirkuit.

Attributes

Atribut Tambahan yang ditentukan menggunakan struktur WDF_OBJECT_ATTRIBUTES yang digunakan untuk mengatur berbagai nilai dan untuk mengaitkan objek peakmeter dengan objek sirkuit induk.

Config

Struktur ACX_PEAKMETER_CONFIG yang diinisialisasi yang menjelaskan konfigurasi peakmeter tingkat audio.

PeakMeter

Penunjuk ke lokasi yang menerima handel ke objek ACXPEAKMETER yang baru dibuat. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan mengembalikan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.

Komentar

Contoh

Contoh penggunaan ditunjukkan di bawah ini.

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

Persyaratan ACX

Versi ACX Minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat gambaran umum versi ACX .

Persyaratan

Syarat	Nilai
Header	acxelements.h
IRQL	PASSIVE_LEVEL

Lihat juga

header acxelements.h

Bagikan melalui