AcxKeywordSpotterCreate-Funktion (acxelements.h)

  • Artikel

Die AcxKeywordSpotterCreate-Funktion wird verwendet, um ein ACX-Schlüsselwort (keyword) Spotterobjekt zu erstellen, das einem übergeordneten Verbindungsgeräteobjekt zugeordnet wird.

Syntax

NTSTATUS AcxKeywordSpotterCreate(
  ACXCIRCUIT                 Object,
  PWDF_OBJECT_ATTRIBUTES     Attributes,
  PACX_KEYWORDSPOTTER_CONFIG Config,
  ACXKEYWORDSPOTTER          *KeywordSpotter
);

Parameter

Object

Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung der Frameworkobjekte), das der Verbindung zugeordnet wird.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert werden, die verwendet werden, um verschiedene Werte festzulegen und das KeywordSpotter-Objekt dem übergeordneten WDF-Geräteobjekt zuzuordnen.

Config

Eine initialisierte ACX_KEYWORDSPOTTER_CONFIG-Struktur, die die Konfiguration des Schlüsselwort (keyword)-Spotters beschreibt.

KeywordSpotter

Ein Zeiger auf einen Speicherort, der das Handle zum neu erstellten ACXKEYWORDSPOTTER-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter 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.

Bemerkungen

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

    ACX_KEYWORDSPOTTER_CALLBACKS_INIT(&keywordSpotterCallbacks);
    keywordSpotterCallbacks.EvtAcxKeywordSpotterRetrieveArm = CodecC_EvtAcxKeywordSpotterRetrieveArm;
    keywordSpotterCallbacks.EvtAcxKeywordSpotterAssignArm = CodecC_EvtAcxKeywordSpotterAssignArm;
    keywordSpotterCallbacks.EvtAcxKeywordSpotterAssignPatterns = CodecC_EvtAcxKeywordSpotterAssignPatterns;
    keywordSpotterCallbacks.EvtAcxKeywordSpotterAssignReset = CodecC_EvtAcxKeywordSpotterAssignReset;

    ACX_KEYWORDSPOTTER_CONFIG_INIT(&keywordSpotterCfg);
    keywordSpotterCfg.Pattern = &CONTOSO_KEYWORDCONFIGURATION_IDENTIFIER2;
    keywordSpotterCfg.Callbacks = &keywordSpotterCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_KEYWORDSPOTTER_CONTEXT);
    attributes.ParentObject = Circuit;

    status = AcxKeywordSpotterCreate(Circuit, &attributes, &keywordSpotterCfg, Element);

ACX-Anforderungen

ACX-Mindestversion: 1.0

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

Anforderungen

Anforderung Wert
Header acxelements.h
IRQL PASSIVE_LEVEL

Weitere Informationen