Partager via

AcxElementCreate, fonction (acxelements.h)

  • Article

La fonction AcxElementCreate permet de créer un objet ACXELEMENT qui sera associé à un parent d’objet d’appareil de circuit ou de flux.

Syntaxe

NTSTATUS AcxElementCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_ELEMENT_CONFIG    Config,
  ACXELEMENT             *Element
);

Paramètres

Object

Objet WDFDEVICE (décrit dans Résumé des objets framework) qui sera associé au flux ou au circuit.

Attributes

Attributs supplémentaires définis à l’aide d’une structure de WDF_OBJECT_ATTRIBUTES qui sont utilisés pour définir diverses valeurs et associer l’élément ACX au flux parent ou à l’objet circuit.

Config

Structure ACX_ELEMENT_CONFIG initialisée qui décrit la configuration de l’élément.

Element

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

Valeur retournée

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

Remarques

Exemple

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

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;

    ACXSTREAM                       stream;

    ACXELEMENT                      elements[2] = {0};
    ACX_ELEMENT_CONFIG              elementCfg;
    CODEC_ELEMENT_CONTEXT *         elementCtx;

    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
    attributes.ParentObject = stream;

    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[0]);

Configuration requise pour ACX

Version ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxelements.h
IRQL PASSIVE_LEVEL

Voir aussi