EVT_ACX_EVENT_ENABLE callback function (acxevents.h)

Artikel
02/22/2024

The EVT_ACX_EVENT_ENABLE callback is used by the driver to enabled the ACXEVENT source.

Syntax

EVT_ACX_EVENT_ENABLE EvtAcxEventEnable;

NTSTATUS EvtAcxEventEnable(
  ACXEVENT Event
)
{...}

Parameters

Event

The ACXEVENT object (described in Summary of ACX Objects).

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

Example

This sample shows the use of the EVT_ACX_EVENT_ENABLE callback.

    //
    // Add enable/disable callbacks for this element.
    //
    ACX_EVENT_CALLBACKS_INIT(&eventCallbacks);
    eventCallbacks.EvtAcxEventEnable = &TestElement::EvtEventEnableCallback; 
    eventCallbacks.EvtAcxEventDisable = &TestElement::EvtEventDisableCallback;

    ACX_EVENT_CONFIG_INIT(&eventCfg);

NTSTATUS
TestElement::EvtEventEnableCallback(
    _In_ ACXEVENT Event
    )
{
    TEST_EVENT_CONTEXT * eventCtx;
    TestElement * This;
    
    PAGED_CODE();

    eventCtx = GetTestEventContext(Event);
    ASSERT(eventCtx != NULL);
    ASSERT(eventCtx->TestElement != NULL);

    This = eventCtx->TestElement;

    // Add code to enable event source.    

    return STATUS_SUCCESS;
}

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement	Value
Header	acxevents.h
IRQL	PASSIVE_LEVEL

Delen via