다음을 통해 공유

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 콜백 함수(acxcircuit.h)

  • 아티클

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 콜백은 드라이버가 ACXCIRCUIT 개체와 연결된 이전에 만든 WDFDEVICE를 삭제해야 하는 경우 ACX에서 호출됩니다.

구문

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

매개 변수

Parent

Device 개체에서 참조되는 WDFDEVICE의 부모인 WDFDEVICE 개체( 프레임워크 개체 요약에 설명됨)입니다.

Factory

기존 회로 팩터리 ACXFACTORYCIRCUIT 개체입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

Device

삭제해야 하는 WDFDEVICE 개체( 프레임워크 개체 요약에 설명됨)입니다.

반환 값

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

설명

AcxFactoryCircuit은 요청 시 ACXCIRCUIT을 만들 수 있는 팩터리 개체를 나타냅니다.

드라이버는 ACX에 하나 이상의 ACXFACTORYCIRCUIT를 등록할 수 있습니다. 이 작업은 드라이버가 잘 정의된 형식의 ACXCIRCUIT를 만들 수 있음을 ACX에 알릴 수 있습니다.

ACX는 오디오 경로에 팩터리 제공 ACXCIRCUIT 중 하나가 필요하다는 것을 감지하면 ACXFACTORYCIRCUIT의 콜백을 호출합니다.

이는 선택적 콜백이며, EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 콜백이 정의되지 않은 경우 ACX는 열거된 디바이스 목록에서 지정된 WDFDEVICE를 제거하는 기본 작업을 수행합니다. 이 작업은 자식 WDFDEVICE에 대해 깜짝 제거된 PnP 알림을 트리거합니다.

ACXFACTORYCIRCUIT 개체는 동적 ACXCIRCUIT를 지원합니다. 즉, 팩터리에서 만든 각 ACXCIRCUIT가 WDFDEVICE와 연결되고 이러한 두 개체의 수명이 동일합니다.

AcxFactoryCircuit에는 전용 WDF 큐가 있습니다. WDF 큐에 대한 자세한 내용은 프레임워크 큐 개체를 참조하세요.

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보