EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 콜백 함수(acxcircuit.h)

  • 아티클

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 콜백은 ACX Manager에서 감지하고 초기화할 때 드라이버가 복합 회로의 초기화를 수행하는 데 사용됩니다.

구문

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;

NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CircuitProperties
)
{...}

매개 변수

Device

지정된 ACXCIRCUIT와 연결된 WDFDEVICE 개체( 프레임워크 개체 요약에 설명됨)입니다.

Circuit

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

CircuitProperties

CircuitProperties에 대한 선택적 핸들입니다. ACXCIRCUIT의 속성에 대한 선택적 ACXOBJECTBAG 개체입니다.

반환 값

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

설명

예제

이 샘플 코드는 드라이버가 지정된 회로 속성 개체 모음에서 회로 속성을 검색하는 방법을 보여 줍니다.

DspR_EvtCircuitCompositeCircuitInitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CircuitProperties
    )
{
    NTSTATUS status = STATUS_SUCCESS;

    PAGED_CODE();
    
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CircuitProperties != NULL)
    {
        DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
        ULONG testUI4;

        status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
        if (!NT_SUCCESS(status))
        {
            // Log error.
            goto exit;
        }

        //...
    }
    
    //...

    // All done.
    status = STATUS_SUCCESS;

exit:
    return status;
}

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보