Compartilhar via

Função AcxCircuitAddElements (acxcircuit.h)

  • Artigo

A função AcxCircuitAddElements adiciona elementos a um ACXCIRCUIT.

Sintaxe

NTSTATUS AcxCircuitAddElements(
  ACXCIRCUIT Circuit,
  ACXELEMENT *Elements,
  ULONG      ElementsCount
);

Parâmetros

Circuit

Um objeto ACXCIRCUIT existente. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Elements

Um ou mais objetos ACXELEMENT que serão adicionados ao circuito.

ElementsCount

O número de elementos que serão adicionados ao circuito. Esta é uma contagem baseada em um.

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

O driver só pode adicionar elementos a um circuito antes que o circuito seja adicionado ao dispositivo. O driver não pode alterar os elementos do circuito em tempo de execução.

Exemplo

O uso de exemplo é mostrado abaixo.


    //
    // Add a second element.
    //
    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
    attributes.ParentObject = circuit;
    
    status = AcxElementCreate(circuit, &attributes, &elementCfg, &elements[1]);

    //
    // Add the elements to the circuit.
    //
    status = AcxCircuitAddElements(circuit, elements, SIZEOF_ARRAY(elements));

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 acxcircuit.h
IRQL PASSIVE_LEVEL

Confira também