Partager via


AcxKeywordSpotterCreate, fonction (acxelements.h)

La fonction AcxKeywordSpotterCreate est utilisée pour créer un objet spotter de mot clé ACX qui sera associé à un parent d’objet d’appareil de circuit.

Syntaxe

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

Paramètres

Object

Objet WDFDEVICE (décrit dans Summary of Framework Objects) qui sera associé au circuit.

Attributes

Attributs supplémentaires définis à l’aide d’une structure WDF_OBJECT_ATTRIBUTES utilisée pour définir différentes valeurs et associer l’objet KeywordSpotter à l’objet d’appareil WDF parent.

Config

Structure de ACX_KEYWORDSPOTTER_CONFIG initialisée qui décrit la configuration du spotter de mots clés.

KeywordSpotter

Pointeur vers un emplacement qui reçoit le handle vers l’objet ACXKEYWORDSPOTTER nouvellement créé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Valeur de retour

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.

Remarques

Exemple

L’exemple d’utilisation est illustré ci-dessous.

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

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxelements.h
IRQL PASSIVE_LEVEL

Voir aussi