EVT_ACX_MUTE_RETRIEVE_STATE Rückruffunktion (acxelements.h)

Die EVT_ACX_MUTE_RETRIEVE_STATE Rückruffunktion wird vom Treiber implementiert und aufgerufen, wenn der Zustand eines angegebenen Kanals auf einem Stummschaltungsknoten angefordert wird.

Syntax

EVT_ACX_MUTE_RETRIEVE_STATE EvtAcxMuteRetrieveState;

NTSTATUS EvtAcxMuteRetrieveState(
  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 aller 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.

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_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;
}

ACX-Anforderungen

AcX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Weitere Informationen

• acxelements.h-Header