Condividi tramite


Funzione AcxPnpEventGenerateEvent (acxevents.h)

La funzione AcxPnpEventGenerateEvent genera un evento ACX PNP.

Sintassi

NTSTATUS AcxPnpEventGenerateEvent(
  ACXPNPEVENT Event,
  PVOID       Payload,
  USHORT      Size
);

Parametri

Event

Oggetto ACXPNPEVENT (descritto in Riepilogo degli oggetti ACX).

Payload

Payload dell'evento.

Size

Dimensioni del payload dell'evento.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Il payload è specifico del tipo di evento PNP generato.

AcXPNPEVENT rappresenta una notifica asincrona disponibile a livello di driver. Gli eventi PNP possono essere aggiunti a tutti gli oggetti. Attualmente vengono usati con oggetti ACXAUDIOMODULE e ACXKEYWARDSPOTTER. Internamente ACXPNPEVENTs vengono esposti come notifica asincrona PNP ai livelli superiori.

Esempio

Questo snip del codice di esempio mostra l'uso di AcxPnpEventGenerateEvent.

        AUDIOMODULE_CUSTOM_NOTIFICATION customNotification = {0};

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

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

Requisiti ACX

Versione minima DI ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxevents.h
IRQL PASSIVE_LEVEL

Vedi anche