AcxPnpEventGenerateEvent - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// acxevents.h

NTSTATUS AcxPnpEventGenerateEvent(
  ACXPNPEVENT Event,
  PVOID       Payload,
  USHORT      Size
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-acxevents-acxpnpeventgenerateevent)

Description

The AcxPnpEventGenerateEvent function generates an ACX PNP event.

Parameters

Event

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

Payload

The event payload.

Size

The size of the event payload.

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

The Payload is specific to the type of PNP event generated.

An ACXPNPEVENT represents an asynchronous notification available at the driver level. PNP events can be added to any objects. Currently they are used with ACXAUDIOMODULE and ACXKEYWARDSPOTTER objects. Internally ACXPNPEVENTs are exposed as PNP asynchronous notification to upper layers.

Example

This example code snip, shows the use of AcxPnpEventGenerateEvent.

        AUDIOMODULE_CUSTOM_NOTIFICATION customNotification = {0};

        customNotification.Type = AudioModuleParameterChanged;
        customNotification.ParameterChanged.ParameterId = command->ParameterId;

        status = AcxPnpEventGenerateEvent(audioModuleCtx->Event, &customNotification, (USHORT)sizeof(customNotification));

ACX requirements

Minimum ACX version: 1.0

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

See also