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 |