다음을 통해 공유

AcxDeviceAddFactoryCircuit 함수(acxdevice.h)

  • 아티클

AcxDeviceAddFactoryCircuit 함수는 오디오 회로를 만들기 위해 WDFDEVICE에 팩터리 회로를 추가합니다.

구문

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

매개 변수

Device

ACX 팩터리 회로를 추가할 WDFDEVICE 입니다.

Factory

Device 매개 변수로 지정된 WDFDEVICE에 추가할 ACX 팩터리 회로입니다.

반환 값

AcxDeviceAddFactoryCircuit 은 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 NTSTATUS 오류 코드가 반환됩니다.

설명

ACX 드라이버는 다음 시나리오에서 하나 이상의 회로를 만들 수 있습니다.

  • 초기화 시
  • 런타임에 새 오디오 구성 요소 검색과 같은 외부 이벤트의 부작용으로
  • ACX를 회로 팩터리로 등록했기 때문입니다. ACX 프레임워크는 등록된 팩터리를 사용하여 드라이버에 새 회로를 만들도록 요청합니다.

AcxDeviceRemoveFactoryCircuit을 사용하여 WDFDEVICE에서 팩터리 회로를 제거합니다.

이 함수는 이 디바이스에 대한 EVT_WDF_DEVICE_PREPARE_HARDWARE 콜백 함수에서만 호출할 수 있습니다.

예제

WDFDEVICE                Device;
NTSTATUS                 status;
PCAPTURE_DEVICE_CONTEXT  devCtx;

// Code to initialize WDFDEVICE...

//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);

if (!NT_SUCCESS(status))
{
    ASSERT(FALSE);
    goto exit;
}

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보