Función AcxElementCreate (acxelements.h)

  • Artículo

La función AcxElementCreate se usa para crear un objeto ACXELEMENT que se asociará con un circuito o objeto de dispositivo de flujo primario.

Sintaxis

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

Parámetros

Object

Objeto WDFDEVICE (descrito en Resumen de objetos de marco) que se asociará al flujo o circuito.

Attributes

Atributos adicionales definidos mediante una estructura de WDF_OBJECT_ATTRIBUTES que se usan para establecer varios valores y para asociar el elemento ACX con el objeto de flujo o circuito primario.

Config

Estructura ACX_ELEMENT_CONFIG inicializada que describe la configuración del elemento.

Element

Puntero a una ubicación que recibe el identificador del objeto ACXELEMENT recién creado. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Ejemplo

A continuación se muestra un ejemplo de uso.

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

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxelements.h
IRQL PASSIVE_LEVEL

Consulte también