AcxCircuitAddElements 함수(acxcircuit.h)

AcxCircuitAddElements 함수는 ACXCIRCUIT에 요소를 추가합니다.

구문

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

매개 변수

Circuit

기존 ACXCIRCUIT 개체입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

Elements

회로에 추가될 하나 이상의 ACXELEMENT 개체입니다.

ElementsCount

회로에 추가될 요소의 수입니다. 이는 하나의 기반 개수입니다.

반환 값

호출이 성공하면 를 반환합니다 STATUS_SUCCESS . 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.

설명

드라이버는 회로가 디바이스에 추가되기 전에 회로에만 요소를 추가할 수 있습니다. 드라이버는 런타임에 회로의 요소를 변경할 수 없습니다.

예제

사용 예제는 다음과 같습니다.

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

ACX 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항	값
헤더	acxcircuit.h
IRQL	PASSIVE_LEVEL

추가 정보

• acxcircuit.h 헤더