Fungsi AcxPeakMeterCreate (acxelements.h)
Fungsi AcxPeakMeterCreate digunakan untuk membuat objek peakmeter ACX yang akan dikaitkan dengan induk objek sirkuit.
Sintaks
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.
Menampilkan nilai
Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.
Keterangan
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
| Persyaratan | Nilai |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |