Compartilhar via

EVT_ACX_MUTE_RETRIEVE_STATE função de retorno de chamada (acxelements.h)

  • Artigo

A função de retorno de chamada EVT_ACX_MUTE_RETRIEVE_STATE é implementada pelo driver e é chamada quando o estado de um canal especificado em um nó mudo é solicitado.

Sintaxe

EVT_ACX_MUTE_RETRIEVE_STATE EvtAcxMuteRetrieveState;

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

Parâmetros

Mute

Um objeto ACXMUTE existente, inicializado. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Channel

Um ULONG que se refere a um canal no nó mudo especificado. Se esse valor for -1, ele se referirá ao canal master que representa o estado de todos os canais no nó mudo.

State

Um ULONG que indica o estado do canal especificado no nó mudo (ou seja, se o canal está mudo ou não). Um valor 0 (FALSE) indica que o canal não está mudo. Um valor de 1 (TRUE) indica que o canal está mudo.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Exemplo

O uso de exemplo é mostrado abaixo.

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

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxelements.h
IRQL PASSIVE_LEVEL

Confira também