EVT_ACX_MUTE_RETRIEVE_STATE funzione di callback (acxelements.h)
La EVT_ACX_MUTE_RETRIEVE_STATE funzione di callback viene implementata dal driver e viene chiamata quando viene richiesto lo stato di un canale specificato in un nodo disattivato.
Sintassi
EVT_ACX_MUTE_RETRIEVE_STATE EvtAcxMuteRetrieveState;
NTSTATUS EvtAcxMuteRetrieveState(
ACXMUTE Mute,
ULONG Channel,
ULONG *State
)
{...}
Parametri
Mute
Oggetto ACXMUTE esistente, inizializzato. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Channel
ULONG che fa riferimento a un canale nel nodo di disattivazione disattivato specificato. Se questo valore è -1, fa riferimento al canale master che rappresenta lo stato di tutti i canali nel nodo disattivato.
State
ULONG che indica lo stato del canale specificato nel nodo disattivato, ad esempio se il canale è disattivato o meno. Il valore 0 (FALSE) indica che il canale non è disattivato. Il valore 1 (TRUE) indica che il canale è disattivato.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Esempio
Di seguito è riportato un esempio di utilizzo.
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;
}
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxelements.h |
| IRQL | PASSIVE_LEVEL |