EVT_ACX_FACTORY_CIRCUIT_POWER_UP 콜백 함수(acxcircuit.h)

  • 아티클

EVT_ACX_FACTORY_CIRCUIT_POWER_UP 콜백은 드라이버가 ACXFACTORYCIRCUIT 개체의 전원 켜기 경로에 기능을 추가하는 데 사용됩니다.

구문

EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;

NTSTATUS EvtAcxFactoryCircuitPowerUp(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE PreviousState
)
{...}

매개 변수

Device

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

Factory

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

PreviousState

이전 디바이스 전원 상태를 식별하는 WDF_POWER_DEVICE_STATE 열거형 입니다.

반환 값

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

드라이버가 이 콜백에 실패하면 ACXFACTORYCIRCUIT에 보류 중인 삭제로 태그를 지정합니다. ACX 프레임워크는 밑줄 ACX EvtDeviceD0Entry 콜백에 실패하지 않습니다. 이렇게 하면 이 디바이스의 기존 ACXFACTORYCIRCUIT를 사용하여 작업 오디오 경로를 빌드할 수 있습니다.

설명

EvtFactoryCircuitPowerUp 콜백 함수를 등록하려면 드라이버가 AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks를 호출해야 합니다.

드라이버가 디바이스에 대해 EvtFactoryCircuitPowerUp 콜백 함수를 등록한 경우 프레임워크는 디바이스가 작동(D0) 상태가 될 때마다 함수를 호출합니다. 다음 중 하나가 발생하면 디바이스가 D0 상태가 됩니다.

  • 디바이스가 열거됩니다(디바이스가 연결되었거나 시스템이 다시 부팅되었기 때문).
  • 시스템 및 모든 디바이스는 저전력 상태에서 작업 상태로 돌아갑니다.
  • 디바이스가 유휴 상태이기 때문에(디바이스가 저전력 유휴 상태를 지원하는 경우) 저전력 상태로 전환된 후 디바이스가 작동 상태로 돌아갑니다.
  • 플러그 앤 플레이 관리자는 시스템의 디바이스 간에 시스템의 하드웨어 리소스를 재배포했습니다.
  • 프레임워크는 디바이스가 작동(D0) 상태가 된 직후에 EvtDeviceD0Entry 콜백 함수를 호출하고 드라이버에서 사용할 수 있지만 디바이스의 인터럽트를 사용하도록 설정하기 전에 호출합니다. PreviousState 매개 변수는 디바이스가 D0 상태가 되기 전에 있었던 디바이스 전원 상태를 식별합니다. 프레임워크가 EvtDeviceD0Entry를 처음 호출하면 WdfPowerDeviceD3Final의 PreviousState 값을 제공합니다.

이 콜백 함수는 디바이스가 완전히 작동하도록 하는 데 필요한 모든 작업을 수행해야 합니다.

이 콜백 함수를 제공하는 드라이버에 대한 자세한 내용은 함수 드라이버에서 PnP 및 전원 관리 지원을 참조하세요.

EvtFactoryCircuitPowerUp 콜백 함수는 IRQL = PASSIVE_LEVEL 호출됩니다. 이 콜백 함수를 페이지스할 수 있도록 해서는 안 됩니다.

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보