EVT_ACX_MUTE_RETRIEVE_STATE fungsi panggilan balik (acxelements.h)

  • Artikel

Fungsi panggilan balik EVT_ACX_MUTE_RETRIEVE_STATE diimplementasikan oleh driver dan dipanggil ketika status saluran tertentu pada simpul bisu diminta.

Sintaks

EVT_ACX_MUTE_RETRIEVE_STATE EvtAcxMuteRetrieveState;

NTSTATUS EvtAcxMuteRetrieveState(
  ACXMUTE Mute,
  ULONG Channel,
  ULONG *State
)
{...}

Parameter

Mute

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

Channel

ULONG yang mengacu pada saluran pada simpul bisu yang ditentukan. Jika nilai ini adalah -1, maka itu mengacu pada saluran master yang mewakili status semua saluran pada simpul bisu.

State

ULONG yang menunjukkan status saluran yang ditentukan pada simpul bisu (yaitu apakah saluran dibisukan atau tidak). Nilai 0 (FALSE) menunjukkan saluran tidak dibisukan. Nilai 1 (TRUE) menunjukkan bahwa saluran dibisukan.

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_MUTE_ELEMENT_CONTEXT {
    BOOL            MuteState[MAX_CHANNELS];
} CODEC_MUTE_ELEMENT_CONTEXT, *PCODEC_MUTE_ELEMENT_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_MUTE_ELEMENT_CONTEXT, GetCodecMuteElementContext)

EVT_ACX_MUTE_RETRIEVE_STATE         CodecR_EvtMuteRetrieveState;

NTAPI
CodecR_EvtMuteRetrieveState(
    _In_  ACXMUTE   Mute,
    _In_  ULONG     Channel,
    _Out_ ULONG *   State
    )
{
    PCODEC_MUTE_ELEMENT_CONTEXT muteCtx;

    PAGED_CODE();

    muteCtx = GetCodecMuteElementContext(Mute);
    ASSERT(muteCtx);

    // use first channel for all channels setting.
    if (Channel != ALL_CHANNELS_ID)
    {
        *State = muteCtx->MuteState[Channel];
    }
    else
    {
        *State = muteCtx->MuteState[0];
    }

    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