EVT_UDECX_USB_DEVICE_D0_EXIT 콜백 함수(udecxusbdevice.h)
USB 디바이스 에뮬레이션 클래스 확장(UdeCx)은 가상 USB 디바이스를 저전력 상태로 보내라는 요청을 받으면 이 콜백 함수를 호출합니다.
통사론
EVT_UDECX_USB_DEVICE_D0_EXIT EvtUdecxUsbDeviceD0Exit;
NTSTATUS EvtUdecxUsbDeviceD0Exit(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] UDECX_USB_DEVICE_WAKE_SETTING WakeSetting
)
{...}
매개 변수
[in] UdecxWdfDevice
USB 디바이스가 연결된 컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UdecxWdfDeviceAddUsbDeviceEmulation대한 이전 호출에서 이 개체를 초기화했습니다.
[in] UdecxUsbDevice
UDE 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UdecxUsbDeviceCreate 이전 호출에서 이 개체를 만들었습니다.
[in] WakeSetting
USB 디바이스의 원격 절전 모드 해제 기능을 나타내는 UDECX_USB_DEVICE_WAKE_SETTING형식 값입니다.
반환 값
작업이 성공하면 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(status)가 TRUE인 다른 상태 값을 반환해야 합니다.
발언
클라이언트 드라이버는 해당 구현에 대한 함수 포인터를 제공하여 UdecxUsbDeviceInitSetStateChangeCallbacks에 대한 이전 호출에서 함수를 등록했습니다.
콜백 구현에서 USB 디바이스의 클라이언트 드라이버는 디바이스를 저전력 상태로 보내는 단계를 수행해야 합니다. 이 함수에서 드라이버는 낮은 링크 전원 상태, 함수 일시 중단 또는 둘 다에서 절전 모드 해제를 시작할 수 있습니다. 이렇게 하려면 USB 2.0 디바이스용 드라이버가 UdecxUsbDeviceSignalWake 메서드를 호출해야 합니다. USB 3.0 디바이스는 UdecxUsbDeviceSignalFunctionWake사용해야 합니다.
전원 요청은 STATUS_PENDING 반환한 다음 나중에 실제 완료 코드로 UdecxUsbDeviceLinkPowerExitComplete 호출하여 비동기적으로 완료될 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 |
| 지원되는 최소 서버 | Windows Server 2016 |
| 대상 플랫폼 | Windows |
| 최소 KMDF 버전 | 1.15 |
| 헤더 | udecxusbdevice.h(Udecx.h 포함) |
| IRQL | <=DISPATCH_LEVEL |