Funzione AcxKeywordSpotterCreate (acxelements.h)

Articolo
02/06/2025

La funzione AcxKeywordSpotterCreate viene usata per creare un oggetto spotter di parole chiave ACX che verrà associato a un elemento padre dell'oggetto dispositivo del circuito.

Sintassi

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

Parametri

Object

Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti framework) che verrà associato al circuito.

Attributes

Attributi aggiuntivi definiti usando una struttura di WDF_OBJECT_ATTRIBUTES utilizzata per impostare vari valori e per associare l'oggetto KeywordSpotter all'oggetto dispositivo WDF padre.

Config

Struttura ACX_KEYWORDSPOTTER_CONFIG inizializzata che descrive la configurazione del rilevatore di parole chiave.

KeywordSpotter

Puntatore a una posizione che riceve l'handle all'oggetto ACXKEYWORDSPOTTER appena creato. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso di valori NTSTATUS.

Osservazioni

Esempio

Di seguito è riportato un esempio di utilizzo.

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

Requisiti ACX

versione minima di ACX: 1.0

Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.

Fabbisogno

Requisito	Valore
intestazione	acxelements.h
IRQL	PASSIVE_LEVEL

Vedere anche

intestazione acxelements.h

Condividi tramite