AcxPnpEventCreate-Funktion (acxevents.h)

  • Artikel

Die AcxPnpEventCreate-Funktion erstellt ein ACXPNPEVENT.

Syntax

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

Parameter

Device

Ein vorhandenes WDFDEVICE-Objekt (beschrieben unter Zusammenfassung der Frameworkobjekte), das dem neuen Ereignis zugeordnet ist.

Object

Ein vorhandenes ACXAUDIOMODULE-Objekt, das unter Zusammenfassung der ACX-Objekte beschrieben wird, die dem Ereignis zugeordnet werden.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES definiert werden, die zum Festlegen der Werte des verschiedenen Objekts verwendet werden: Bereinigen und Zerstören von Rückrufen, Kontexttyp und angeben des übergeordneten Objekts.

Config

Eine ACX_PNPEVENT_CONFIG-Struktur , die die Konfiguration für ein ACX-PNP-Ereignis definiert.

Event

Das ACXEVENT-Objekt (beschrieben in Zusammenfassung von ACX-Objekten).

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Hinweise

Ein ACXPNPEVENT stellt eine asynchrone Benachrichtigung dar, die auf Treiberebene verfügbar ist. PNP-Ereignisse können jedem Objekt hinzugefügt werden. Derzeit werden sie mit ACXAUDIOMODULE- und ACXKEYWARDSPOTTER-Objekten verwendet. Intern werden AcxPnpEvents als asynchrone PNP-Benachrichtigung für obere Ebenen verfügbar gemacht.

Beispiel

In diesem Beispielcode wird die Verwendung von AcxPnpEventCreate veranschaulicht.

    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);

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxevents.h
IRQL PASSIVE_LEVEL

Weitere Informationen