EVT_ACX_MUTE_RETRIEVE_STATE función de devolución de llamada (acxelements.h)

  • Artículo

El controlador implementa la función de devolución de llamada EVT_ACX_MUTE_RETRIEVE_STATE y se llama cuando se solicita el estado de un canal especificado en un nodo de exclusión.

Sintaxis

EVT_ACX_MUTE_RETRIEVE_STATE EvtAcxMuteRetrieveState;

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

Parámetros

Mute

Objeto ACXMUTE existente, inicializado. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Channel

Un ULONG que hace referencia a un canal en el nodo de exclusión especificado. Si este valor es -1, hace referencia al canal maestro que representa el estado de todos los canales del nodo silenciado.

State

ULONG que indica el estado del canal especificado en el nodo silenciado (es decir, si el canal está silenciado o no). Un valor de 0 (FALSE) indica que el canal no está silenciado. Un valor de 1 (TRUE) indica que el canal está silenciado.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Ejemplo

A continuación se muestra el uso de ejemplo.

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 de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxelements.h
IRQL PASSIVE_LEVEL

Consulte también