EVT_ACX_MUTE_ASSIGN_STATE Rückruffunktion (acxelements.h)

  • Artikel

Die EVT_ACX_MUTE_ASSIGN_STATE Rückruffunktion wird vom Treiber implementiert und aufgerufen, wenn der Zustand eines angegebenen Kanals auf einem Stummschaltknoten festgelegt ist. Der Zustand des Kanals kann auf 0 (FALSE) oder 1 (TRUE) festgelegt werden, wobei 0 angibt, dass der Kanal nicht stummgeschaltet ist und 1 angibt, dass der Kanal stummgeschaltet ist.

Syntax

EVT_ACX_MUTE_ASSIGN_STATE EvtAcxMuteAssignState;

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

Parameter

Mute

Ein vorhandenes, initialisiertes ACXMUTE-Objekt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.

Channel

Eine ULONG, die auf einen Kanal auf dem angegebenen Stummschaltknoten verweist. Wenn dieser Wert -1 ist, bezieht er sich auf den master Kanal, der den Zustand für alle Kanäle auf dem Stummschaltknoten darstellt.

State

Eine ULONG, die den Zustand des angegebenen Kanals auf dem Stummschaltknoten angibt (d. h. ob der Kanal stummgeschaltet ist oder nicht). Der Wert 0 (FALSE) gibt an, dass der Kanal nicht stummgeschaltet ist. Der Wert 1 (TRUE) gibt an, dass der Kanal stummgeschaltet ist. Wenn der Kanalwert -1 ist (bezieht sich auf den master Kanal), werden alle Kanäle auf diesem Stummschaltknoten auf diesen Zustand festgelegt.

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.

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_ASSIGN_STATE           CodecR_EvtMuteAssignState;

NTSTATUS
NTAPI
CodecR_EvtMuteAssignState(
    _In_ ACXMUTE    Mute,
    _In_ ULONG      Channel,
    _In_ ULONG      State
    )
{
    PCODEC_MUTE_ELEMENT_CONTEXT muteCtx;
    ULONG                       i;

    PAGED_CODE();

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

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

    return STATUS_SUCCESS;
}

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