EVT_ACX_MUTE_ASSIGN_STATE Rückruffunktion (acxelements.h)
Die EVT_ACX_MUTE_ASSIGN_STATE Rückruffunktion wird vom Treiber implementiert und aufgerufen, wenn der Status eines angegebenen Kanals auf einem Stummschaltknoten festgelegt ist. Der Status 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 Summary of ACX Objects.
Channel
Ein ULONG, der auf einen Kanal auf dem angegebenen Stummschaltknoten verweist. Wenn dieser Wert -1 lautet, verweist er auf den Masterkanal, der den Status für alle 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. Wenn der Kanalwert -1 ist (verweisen auf den Masterkanal), werden alle Kanäle auf diesem Stummschaltknoten auf diesen Zustand festgelegt.
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_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
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 |