Função AcxPnpEventGenerateEvent (acxevents.h)
A função AcxPnpEventGenerateEvent gera um evento PNP ACX.
Sintaxe
NTSTATUS AcxPnpEventGenerateEvent(
ACXPNPEVENT Event,
PVOID Payload,
USHORT Size
);
Parâmetros
Event
O objeto ACXPNPEVENT (descrito em Resumo de Objetos ACX).
Payload
O conteúdo do evento.
Size
O tamanho do conteúdo do evento.
Valor de retorno
Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.
Observações
O Payload é específico para o tipo de evento PNP gerado.
Um ACXPNPEVENT representa uma notificação assíncrona disponível no nível do driver. Eventos PNP podem ser adicionados a qualquer objeto. Atualmente, eles são usados com objetos ACXAUDIOMODULE e ACXKEYWARDSPOTTER. Internamente, as ACXPNPEVENTs são expostas como notificação assíncrona PNP para camadas superiores.
Exemplo
Este exemplo de código snip mostra o uso de AcxPnpEventGenerateEvent.
AUDIOMODULE_CUSTOM_NOTIFICATION customNotification = {0};
customNotification.Type = AudioModuleParameterChanged;
customNotification.ParameterChanged.ParameterId = command->ParameterId;
status = AcxPnpEventGenerateEvent(audioModuleCtx->Event, &customNotification, (USHORT)sizeof(customNotification));
Requisitos do ACX
versão mínima do ACX: 1.0
Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | acxevents.h |
| IRQL | PASSIVE_LEVEL |