Compartilhar via


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

A carga do evento.

Size

O tamanho do conteúdo do evento.

Retornar valor

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.

Comentários

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, ACXPNPEVENTs são expostos como notificação assíncrona PNP para camadas superiores.

Exemplo

Este exemplo de captura de código 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

Confira também