EVT_ACX_PEAKMETER_RETRIEVE_LEVEL fungsi panggilan balik (acxelements.h)

  • Artikel

Fungsi panggilan balik EVT_ACX_PEAKMETER_RETRIEVE_LEVEL diimplementasikan oleh driver dan dipanggil ketika tingkat saluran tertentu pada simpul peakmeter diminta.

Sintaks

EVT_ACX_PEAKMETER_RETRIEVE_LEVEL EvtAcxPeakmeterRetrieveLevel;

NTSTATUS EvtAcxPeakmeterRetrieveLevel(
  ACXPEAKMETER PeakMeter,
  ULONG Channel,
  LONG *Level
)
{...}

Parameter

PeakMeter

Objek ACXPEAKMETER yang sudah ada dan diinisialisasi. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.

Channel

ULONG yang mengacu pada saluran pada simpul peakmeter yang ditentukan. Jika nilai ini adalah -1, maka itu mengacu pada saluran master yang mengatur tingkat untuk semua saluran pada simpul puncak.

Level

Nilai LONG yang menunjukkan tingkat sinyal audio maksimum yang terjadi untuk saluran yang ditentukan pada simpul puncak sejak terakhir kali simpul puncak diatur ulang.

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.

typedef struct _CODEC_PEAKMETER_ELEMENT_CONTEXT {
    LONG            PeakMeterLevel[MAX_CHANNELS];
} CODEC_PEAKMETER_ELEMENT_CONTEXT, *PCODEC_PEAKMETER_ELEMENT_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_PEAKMETER_ELEMENT_CONTEXT, GetCodecPeakMeterElementContext)

EVT_ACX_PEAKMETER_RETRIEVE_LEVEL    CodecR_EvtPeakMeterRetrieveLevelCallback;

NTSTATUS
NTAPI
CodecR_EvtPeakMeterRetrieveLevelCallback(
    _In_    ACXPEAKMETER    PeakMeter,
    _In_    ULONG           Channel,
    _Out_   LONG *          PeakMeterLevel
    )
{
    PAGED_CODE();

    ASSERT(PeakMeter);
    PCODEC_PEAKMETER_ELEMENT_CONTEXT peakmeterCtx = GetCodecPeakMeterElementContext(PeakMeter);
    ASSERT(peakmeterCtx);

    if (Channel == ALL_CHANNELS_ID)
    {
        Channel = 0;
    }

    *PeakMeterLevel = peakmeterCtx->PeakMeterLevel[Channel];

    return STATUS_SUCCESS;
}

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

Lihat juga