Función AcxPnpEventCreate (acxevents.h)

La función AcxPnpEventCreate crea un ACXPNPEVENT.

Sintaxis

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

Parámetros

Device

Objeto WDFDEVICE existente (descrito en Resumen de objetos de marco) que se asociará al nuevo evento.

Object

Objeto ACXAUDIOMODULE existente que se describe en Resumen de objetos ACX que se asociarán al evento.

Attributes

Atributos adicionales definidos mediante un WDF_OBJECT_ATTRIBUTES que se usan para establecer los valores de los distintos objetos: limpieza y destrucción de devoluciones de llamada, tipo de contexto y para especificar su objeto primario.

Config

Estructura ACX_PNPEVENT_CONFIG que define la configuración de un evento PNP de ACX.

Event

Objeto ACXEVENT (descrito en Resumen de objetos ACX).

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

AcXPNPEVENT representa una notificación asincrónica disponible en el nivel de controlador. Los eventos PNP se pueden agregar a cualquier objeto . Actualmente se usan con objetos ACXAUDIOMODULE y ACXKEYWARDSPOTTER. Los eventos AcxPnpEvents se exponen internamente como notificación asincrónica de PNP a las capas superiores.

Ejemplo

En este código de ejemplo se muestra el 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 de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Consulte también

• Encabezado acxevents.h