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 Status eines angegebenen Kanals auf einem Stummschaltknoten 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 Summary of ACX Objects.
Channel
Ein ULONG, der auf einen Kanal auf dem angegebenen Stummschaltknoten verweist. Wenn dieser Wert -1 ist, verweist er auf den Masterkanal, der den Status aller Kanäle auf dem Stummschaltknoten darstellt.
State
Ein ULONG, der den Status des angegebenen Kanals auf dem Stummschaltknoten angibt (d. h. ob der Kanal stummgeschaltet ist oder nicht). Ein Wert von 0 (FALSE) gibt an, dass der Kanal nicht stummgeschaltet ist. Ein Wert von 1 (TRUE) gibt an, dass der Kanal stummgeschaltet ist.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Die Beispielverwendung wird unten gezeigt.
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
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxelements.h |
| IRQL- | PASSIVE_LEVEL |