EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST función de devolución de llamada (acxrequest.h)

Artículo
04/30/2024

El controlador usa la EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST devolución de llamada para controlar las notificaciones de eventos.

Sintaxis

EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST EvtAcxObjectProcessEventRequest;

void EvtAcxObjectProcessEventRequest(
  ACXOBJECT Object,
  ACXEVENT Event,
  ACX_EVENT_VERB Verb,
  ACXEVENTDATA EventData,
  WDFREQUEST Request
)
{...}

Parámetros

Object

Objeto ACX asociado a la solicitud.

Event

Objeto ACXEVENT (descrito en Resumen de objetos ACX). Objeto AcxEvent que representa una notificación asincrónica disponible en el nivel de controlador. Los eventos se pueden agregar a AcxCircuits, AcxStreams, AcxElements y AcxPins. Internamente, se exponen como eventos KS a capas superiores.

Verb

Verbo de la enumeración ACX_EVENT_VERB que describe el tipo de operación.

EventData

Objeto ACXEVENTDATA ACX opcional que proporciona información sobre el evento.

Request

Objeto WDFREQUEST opcional asociado a esta operación.

Para obtener más información sobre cómo trabajar con objetos de solicitud WDF, vea Creating Framework Request Objects and wdfrequest.h header.

Valor devuelto

None

Notas

Ejemplo

A continuación se muestra el uso de ejemplo.


EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST CodecR_EvtMuteElementChangeEventCallback;

...


VOID
CodecR_EvtMuteElementChangeEventCallback(
    _In_        ACXOBJECT       Object,
    _In_        ACXEVENT        Event,
    _In_        ACX_EVENT_VERB  Verb,
    _In_opt_    ACXEVENTDATA    EventData,
    _In_opt_    WDFREQUEST      Request
    )
{
    NTSTATUS                    status = STATUS_NOT_SUPPORTED;
    PCODEC_MUTE_ELEMENT_CONTEXT muteCtx = NULL;
    CODEC_MUTE_EVENT_CONTEXT *  muteEventCtx;
    
    PAGED_CODE();
    
    muteCtx = GetCodecMuteElementContext(Object);
    ASSERT(muteCtx);

    // for testing.
    muteEventCtx = GetCodecMuteEventContext(Event);
    ASSERT(muteEventCtx);

    //
    // Take the correct action: enable/disable.
    //
    switch (Verb)
    {
    case AcxEventVerbEnable:
        AcxEventAddEventData(Event, EventData);
        WdfTimerStart(muteEventCtx->Timer, WDF_REL_TIMEOUT_IN_MS(10));
        status = STATUS_SUCCESS;
        break;
        
    case AcxEventVerbBasicSupport:
        status = STATUS_SUCCESS;
        break;
        
    case AcxEventVerbDisable:
        ASSERT(Request == NULL);
        //
        // Verb is AcxEventVerbDisable;
        // It is ok to generate events even if no one is listening.
        // If present, ACX completes the request associated with this action.
        //
        break;
        
    default:
        ASSERT(FALSE);
        status = STATUS_INVALID_DEVICE_REQUEST;
        break;
    }

    if (Request != NULL)
    {
        WdfRequestComplete(Request, status); 
    }
}

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	acxrequest.h
IRQL	PASSIVE_LEVEL

Consulte también

[encabezado acxrequest.h] (index.md)

Share via