Share via

Função AcxElementCreate (acxelements.h)

  • Artigo

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

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 framework) 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.

Retornar valor

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.

Comentários

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 as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxelements.h
IRQL PASSIVE_LEVEL

Confira também