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(상태)이 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 |