Funzione AcxPnpEventGenerateEvent (acxevents.h)
La funzione AcxPnpEventGenerateEvent genera un evento PNP ACX.
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 di valori NTSTATUS.
Osservazioni
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 qualsiasi oggetto. Attualmente vengono usati con oggetti ACXAUDIOMODULE e ACXKEYWARDSPOTTER. Internamente ACXPNPEVENTs vengono esposti come notifica asincrona PNP ai livelli superiori.
Esempio
Questo esempio di snip di codice 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 di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxevents.h |
| IRQL | PASSIVE_LEVEL |