Função AcxElementCreate (acxelements.h)

Artigo
02/06/2025

A função AcxElementCreate é usada para criar um objeto ACXELEMENT que será associado a um circuito ou objeto de dispositivo de fluxo pai.

Sintaxe

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

Parâmetros

Object

Um objeto WDFDEVICE (descrito em Resumo de Objetos da Estrutura) que será associado ao fluxo ou circuito.

Attributes

Atributos adicionais definidos usando uma estrutura WDF_OBJECT_ATTRIBUTES que são usados para definir vários valores e associar o elemento ACX ao objeto de circuito ou fluxo pai.

Config

Uma estrutura de ACX_ELEMENT_CONFIG inicializada que descreve a configuração do elemento.

Element

Um ponteiro para um local que recebe o identificador para o objeto ACXELEMENT recém-criado. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Valor de retorno

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Observações

Exemplo

O uso de exemplo é mostrado abaixo.

    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 do ACX

versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.

Requisitos

Requisito	Valor
cabeçalho	acxelements.h
IRQL	PASSIVE_LEVEL

Consulte também

cabeçalho acxelements.h

Partilhar via