EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE 콜백 함수(acxcircuit.h)

아티클
02/26/2024

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE 콜백은 드라이버가 ACX Manager에서 초기화를 해제할 때 복합 회로의 초기화를 해제하는 데 사용됩니다.

구문

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;

void EvtAcxCircuitCompositeDeinitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

매개 변수

Device

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

Circuit

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

CompositeProperties

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

반환 값

없음

설명

ACX는 연결된 WDFDEVICE가 있는 경우에만 복합 ACXCIRCUIT에 대해 이 콜백을 호출할 수 있습니다. 즉, 연결된 WDFDEVICE가 SR(서프라이즈 제거)인 경우 연결된 PnP 인터페이스가 꺼져 있으므로 ACX는 콜백을 호출할 수 없습니다.

예제

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

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

VOID
DspR_EvtCircuitCompositeDeinitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CompositeProperties
    )
{
    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    NTSTATUS    status      = STATUS_SUCCESS;
    GUID        uniqueId    = {0};

    PAGED_CODE();

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CompositeProperties)
    {
        status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);
        if (!NT_SUCCESS(status))
        {
            // Log error.
        }
    }
}

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보

acxcircuit.h 헤더