Compartilhar via

Função AcxPnpEventCreate (acxevents.h)

  • Artigo

A função AcxPnpEventCreate cria um ACXPNPEVENT.

Sintaxe

NTSTATUS AcxPnpEventCreate(
  WDFDEVICE              Device,
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_PNPEVENT_CONFIG   Config,
  ACXPNPEVENT            *Event
);

Parâmetros

Device

Um objeto WDFDEVICE existente (descrito em Resumo de Objetos da Estrutura) que está associado ao novo evento.

Object

Um objeto ACXAUDIOMODULE existente descrito em Resumo de Objetos ACX que serão associados ao evento.

Attributes

Atributos adicionais definidos usando um WDF_OBJECT_ATTRIBUTES que são usados para definir os valores de vários objetos: limpar e destruir retornos de chamada, tipo de contexto e especificar seu objeto pai.

Config

Uma estrutura ACX_PNPEVENT_CONFIG que define a configuração de um evento PNP ACX.

Event

O objeto ACXEVENT (descrito em Resumo de Objetos ACX).

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

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 código de exemplo mostra o uso de AcxPnpEventCreate.

    NTSTATUS                        status;
    ACXAUDIOMODULE                  audioModuleElement;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACX_PNPEVENT_CONFIG             audioModuleEventCfg;
    ACXPNPEVENT                     audioModuleEvent;

    ...

    status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);
    audioModule0Ctx = GetCodecAudioModule0Context(audioModuleElement);

    ACX_PNPEVENT_CONFIG_INIT(&audioModuleEventCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_PNPEVENT_CONTEXT);
    attributes.ParentObject = audioModuleElement;
    status = AcxPnpEventCreate(Device, audioModuleElement, &attributes, &audioModuleEventCfg, &audioModuleEvent);

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as 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