функция обратного вызова EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST (acxrequest.h)

Статья
04/30/2024

Обратный вызов EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST используется драйвером для обработки уведомлений о событиях.

Синтаксис

EVT_ACX_OBJECT_PROCESS_EVENT_REQUEST EvtAcxObjectProcessEventRequest;

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

Параметры

Object

Объект ACX, связанный с запросом.

Event

Объект ACXEVENT (описан в разделе Сводка по объектам ACX). Объект AcxEvent, представляющий асинхронное уведомление, доступное на уровне драйвера. События можно добавлять в AcxCircuits, AcxStreams, AcxElements и AcxPins. Внутри они предоставляются в качестве событий KS на верхних слоях.

Verb

Глагол из перечисления ACX_EVENT_VERB , описывающий тип операции.

EventData

Необязательный объект ACXEVENTDATA, предоставляющий сведения о событии.

Request

Необязательный объект WDFREQUEST, связанный с этой операцией.

Дополнительные сведения о работе с объектами запросов WDF см. в разделах Creating Framework Request Objects и wdfrequest.h header.

Возвращаемое значение

None

Remarks

Пример

Ниже приведен пример использования.


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

Требования ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование	Значение
Заголовок	acxrequest.h
IRQL	PASSIVE_LEVEL

См. также раздел

[заголовок acxrequest.h] (index.md)

Поделиться через